FSH_UPPERCASE - Uppercase ASCIIZ string

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: 

oERROR_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.