[Toc][Index]

FSH_CHECKEANAME - Check for valid EA name

  
Purpose   
Check extended attribute name validity. 
Calling Sequence   

int far pascal FSH_CHECKEANAME(iLevel, cbEAName, szEAName)

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


Where   
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: 
oERROR_INVALID_NAME 
pathname contains invalid or wildcard characters, or is too long. 
oERROR_INVALID_PARAMETER 
invalid level. 
  
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.   

Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs