NWScanLogicalLocksByName(3nw)


NWScanLogicalLocksByName -- scans for record locks in logical name

Synopsis

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

NWCCODE N_API NWScanLogicalLocksByName (NWCONN_HANDLE conn, pnstr8 logicalName, pnint16 iterHandle, LOGICAL_LOCK N_FAR * logicalLock, LOGICAL_LOCKS N_FAR * logicalLocks);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

logicalName
(IN) Points to the logical lock name to be scanned.

iterHandle
(IN/OUT) Points to the number of the next record to be scanned.

logicalLock
(OUT) Points to LOGICAL_LOCK (optional).

logicalLocks
(OUT) Points to LOGICAL_LOCKS.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x88FF
Scan Completed

0x8996
SERVER_OUT_OF_MEMORY

0x89C6
NO_CONSOLE_PRIVILEGES

Notices

iterHandle should be set to 0 initially. Each subsequent call returns the number of the next record to be scanned. iterHandle returns -1 upon completion and should not be changed during the scan.

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

Services

Synchronization

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 224 0x2222~23~224~T{Get Logical Record Information (2.x)
0x2222 23 240 Get Logical Record Information (3.x-4.x)

 
 0x2222   23   17    Get File Server Information 
 0x2222   23   224   T{Get Logical Record Information (2.x) 
 T} 
 0x2222   23   240   Get Logical Record Information (3.x- 
                     4.x) 

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