NWScanSemaphoresByName(3nw)


NWScanSemaphoresByName -- scans information about semaphore

Synopsis

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

NWCCODE N_API NWScanSemaphoresByName (NWCONN_HANDLE conn, pnstr8 semName, pnint16 iterHandle, SEMAPHORE N_FAR * semaphore, SEMAPHORES N_FAR * semaphores);

Description

The parameters are as follows:

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

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 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.

Services

Synchronization

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 226 Get Semaphore Information (2.x)
0x2222 23 242 Get Semaphore Information (3.x-4.x)

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   226   Get Semaphore 
                     Information 
                     (2.x) 
 0x2222   23   242   Get Semaphore 
                     Information 
                     (3.x-4.x) 

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.