Purpose

This function is used to uppercase an ASCIIZ string.

Calling Sequence

int far pascal FSH_UPPERCASE(szPathName, cbPathBuf, pPathBuf)
 
char far * szPathName;
unsigned short cbPathBuf;
char far * pPathBuf;

Where

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.

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.