FSH UPPERCASE

This function is used to uppercase an ASCIIZ string.

Syntax

FSH_UPPERCASE(szPathName, cbPathBuf, pPathBuf)

Parameters

szPathName: is a pointer to the ASCIIZ pathname to be uppercased.
cbPathBuf: is the length of the pathname buffer.
pPathBuf: is a pointer to the buffer to copy the uppercased path into

Returns

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

ERROR_BUFFER_OVERFLOW :uppercased pathname is too long to fit into buffer.

Calling Sequence

int far pascal FSH_UPPERCASE(szPathName, cbPathBuf, pPathBuf)

char far * szPathName;
unsigned short cbPathBuf;
char far * pPathBuf;

Remarks

This routine processes DBCS characters properly.

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

szPathName and pPathBuf may point to the same place in memory.

FSH_UPPERCASE should be called for names passed into the FSD in raw data packets which are not passed to FSH_CANONICALIZE and should be uppercased, that is, extended attribute names.

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