FSH_CHECKEANAME

Check extended attribute name validity.

Syntax

FSH_CHECKEANAME(iLevel, cbEAName, szEAName)

Parameters

iLevel: is the extended attributes name checking level.; iLevel = 0x0001 indicates OS/2 Version 2.0 name checking.
cbEAName: is the length of the extended attribute name, not including terminating NUL.
szEAName: is the extended attribute name to check for validity.

Returns

If no error is detected, a zero error code is returned. If an error is detected, one of the following error codes is returned:

ERROR_INVALID_NAME : pathname contains invalid or wildcard characters, or is too long.
ERROR_INVALID_PARAMETER : invalid level.

Calling Sequence

int far pascal FSH_CHECKEANAME(iLevel, cbEAName, szEAName)

unsigned short iLevel;
unsigned long cbEAName;
char far * szEAName;

Remarks

This routine processes DBCS characters properly.

The set of invalid characters for EA names is the same as that for filenames. In OS/2 Version 2.0, the maximum length of an EA name, not including the terminating NUL, is 255 bytes. The minimum length is 1 byte.

The FSD is responsible for verifying the string pointers and checking for segment boundaries.

FSH_CHECKEANAME should be called for extended attribute names passed to the FSD.

Note: OS/2 does not validate input parameters. Therefore, an FSD should call FSH_PROBEBUF where appropriate.