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)
|
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.