Syntax

  #include <nwsync.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY(NWCCODE) NWScanSemaphoresByName ( 
     NWCONN_HANDLE        conn,  
     const nstr8 N_FAR   *semName,  
     pnint16              iterHandle,  
     SEMAPHORE N_FAR     *semaphore,  
     SEMAPHORES N_FAR    *semaphores);
  

Delphi Syntax

  uses calwin32 
   
  Function NWScanSemaphoresByName 
    (conn : NWCONN_HANDLE; 
     semName : pnstr8; 
     iterHandle : pnint16; 
     Var semaphore : SEMAPHORE; 
     Var semaphores : SEMAPHORES 
  ) : NWCCODE;
  

Parameters

conn

(IN) Specifies the NetWare server connection handle.

semName

(IN) Points to the semaphore name to be scanned.

iterHandle

(IN/OUT) Points to the number of the next record to be scanned; should be set to 0 initially.

semaphore

(OUT) Points to SEMAPHORE (optional).

semaphores

(OUT) Points to SEMAPHORES.

Return Values

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

Remarks

The client must have console operator rights to call NWScanSemaphoresByName.

iterHandle returns -1 upon completion, and should not be changed during the scan.

If semaphore is a NULL pointer, semaphores returns the records in groups, instead of one by one .

NCP Calls

• 0x2222 23 17 Get File Server Information
• 0x2222 23 242 Get Semaphore Information