dos12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
DosQNmPipeSemState (1.2)
Function Group  Overview  Changes               Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSNMPIPES
 
USHORT DosQNmPipeSemState(hsem, pnmpsmst, cbBuf)
HSEM hsem;                 /* semaphore handle                        */
PPIPESEMSTATE pnmpsmst;    /* pointer to buffer receiving information */
USHORT cbBuf;              /* buffer size                             */
 
The DosQNmPipeSemState function returns information about all local named
pipes that are in blocking mode and are associated with a specified system
semaphore.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hsem       Identifies the semaphore that is associated with the named pipe.
 
pnmpsmst   Points to the PIPESEMSTATE structure that receives the
           information.
 
cbBuf      Specifies the length (in bytes) of the structure that receives
           the information. Programs written in the C language should use
           the sizeof operator to set this parameter.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be one of the following:
 
     ERROR_INVALID_PARAMETER
     ERROR_SEM_NOT_FOUND
 
See Also
 
DosSetNmPipeSem, PIPESEMSTATE