NWScanSemaphoresByConn(3nw)


NWScanSemaphoresByConn -- scans information about semaphores opened by connection

Synopsis

   #include <nwsync.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWScanSemaphoresByConn (NWCONN_HANDLE conn, NWCONN_NUM connNum, pnint16 iterHandle, CONN_SEMAPHORE N_FAR * semaphore, CONN_SEMAPHORES N_FAR * semaphores);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

connNum
(IN) Specifies the connection number of the logged-in object 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 CONN_SEMAPHORE(optional).

semaphores
(OUT) Points to CONN_SEMAPHORES.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x88FF
Scan Completed

0x8996
SERVER_OUT_OF_MEMORY

0x89C6
NO_CONSOLE_PRIVILEGES

Notices

The client must have console operator rights to call NWScanSemaphoresByConn.

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

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

NWScanSemaphoresByConn returns SUCCESSFUL even when connNum is invalid. Call NWGetFileServerInformation to return the maxConns supported for the specific file server. Only use connNum in the range of zero-maxConns.

Services

Synchronization

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 225 Get Connection's Semaphores (2.x)
0x2222 23 241 Get Connection's Semaphores (3.x-4.x)

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   225   Get 
                     Connection's 
                     Semaphores 
                     (2.x) 
 0x2222   23   241   Get 
                     Connection's 
                     Semaphores 
                     (3.x-4.x) 

References

NWGetObjectConnectionNumbers(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.