NWSignalSemaphore

Increments the semaphore value by one

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Synchronization

Syntax

  #include <nwsync.h> 
  or 
   #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY( NWCCODE )NWSignalSemaphore  ( 
     NWCONN_HANDLE   conn,  
     nuint32         semHandle);
  

Delphi Syntax

  uses calwin32 
   
  Function NWSignalSemaphore 
    (conn : NWCONN_HANDLE; 
     semHandle : nuint32 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
semHandle
(IN) Specifies the semaphore handle of the semaphore to be signaled (obtained by calling NWOpenSemaphore).

Return Values

These are common return values; see Return Values (NDK: Connection, Message, and NCP Extensions) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89F

LOCK_ERROR

Remarks

If another client is waiting on the semaphore, a successful completion code is returned to the waiting client.

An application must call NWSignalSemaphore when it finishes accessing the network resource associated with the semaphore. If processes are waiting to use the semaphore, the first process in the queue is released (signaled).

NCP Calls

See Also

NWCloseSemaphore, NWExamineSemaphore, NWOpenSemaphore, NWWaitOnSemaphore