SignalSemaphore

Increments the value of the specified semaphore

Local Servers:nonblocking
Remote Servers:blocking
Classification:3.x, 4.x, 5.x, 6.x
Service:Server-Based Synchronization

Syntax

  #include <\nlm\nit\nwsync.h>  
   
  int SignalSemaphore (  
     long   semaphoreHandle); 
  

Parameters

semaphoreHandle
(IN) Specifies the semaphore handle of an open semaphore.

Return Values

Decimal

Hex

Constant

0

(0x00)

ESUCCESS

1

(0x01)

ERR_INSUFFICIENT_SPACE

255

(0xFF)

ERR_INVALID_SEMAPHORE_HANDLE

Remarks

For cross-platform functionality, call NWSignalSemaphore.

An application must call this function when finished accessing the network resource associated with the semaphore. If there are processes waiting to use the semaphore (the semaphore value is negative), the first process in the queue is released (signaled).

An application should obtain a semaphore handle by calling OpenSemaphore.

See Also

CloseSemaphore, ExamineSemaphore, OpenSemaphore, WaitOnSemaphore