View source for FSH ADDSHARE

This function adds a name to the currently active sharing set.   

==Syntax==
 FSH_ADDSHARE(pName, mode, hVPB, phShare)
==Parameters==
;pName: is a pointer to the ASCIIZ name to be added into the share set.   

:The name must be in canonical form: no '.' or '. .' components, uppercase, no meta characters, and full path name specified .   

;mode: is the sharing mode and access mode as defined in the DosOpen API. All other bits (direct open, write-through, etc.) must be zero.   

;hVPB: is the handle to the volume where the named object is presumed to exist .   

;phShare: is the pointer to the location where a share handle is stored. This handle may be passed to FSH_REMOVESHARE. 
  
==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_SHARING_VIOLATION 
::the file is open with a conflicting sharing/access mode.   

:*ERROR_TOO_MANY_OPEN_FILES 
::there are too many files open at the present time.   

:*ERROR_SHARING_BUFFER_EXCEEDED 
::there is not enough memory to hold sharing information.   

:*ERROR_INVALID_PARAMETER 
::invalid bits in mode.   

:*ERROR_FILENAME_EXCED_RANGE 
::path name is too long. 
==Calling Sequence==
<PRE>
int far pascal FSH_ADDSHARE(pName, mode, hVPB, phShare)

char far * pName;
unsigned short mode;
unsigned short hVPB;
unsigned long far * phShare;
</PRE>
==Remarks==
Do not call FSH_ADDSHARE for character devices.   

FSH_ADDSHARE may block.   

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

[[Category:IFS Interfaces]]
{{DISPLAYTITLE:FSH_ADDSHARE}}