NWScanLogicalLocksByConn(3nw)


NWScanLogicalLocksByConn -- scans for logical record locks in connection

Synopsis

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

NWCCODE N_API NWScanLogicalLocksByConn (NWCONN_HANDLE conn, NWCONN_NUM connNum, pnint16 iterHandle, CONN_LOGICAL_LOCK N_FAR * logicalLock, CONN_LOGICAL_LOCKS N_FAR * logicalLocks);

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.

logicalLock
(OUT) Points to CONN_LOGICAL_LOCK (optional).

logicalLocks
(OUT) Points to CONN_LOGICAL_LOCKS.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x89C6
NO_CONSOLE_PRIVILEGES

0x89FD
BAD_STATION_NUMBER

0x88FF
Scan Completed

Notices

The client must have console operator rights to call NWScanLogicalLocksByConn.

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.

CONN_LOGICAL_LOCKS is a buffer and should be passed to subsequent NWScanLogicalLocksByConn calls without modification.

If you pass a non-NULL pointer to logicalLock, CONN_LOGICAL_LOCKS passes one record at a time to CONN_LOGICAL_LOCK. If you pass a NULL pointer to logicalLock, CONN_LOGICAL_LOCKS is filled but no records are passed to CONN_LOGICAL_LOCK.

0x88FF is returned when the last record has been passed to CONN_LOGICAL_LOCK and NWScanLogicalLocksByConn is called subsequently.

Services

Synchronization

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 223 Get Logical Records By Connection (2.x)
0x2222 23 239 Get Logical Records By Connection (3.x-4.x)

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   223   Get Logical 
                     Records By 
                     Connection 
                     (2.x) 
 0x2222   23   239   Get Logical 
                     Records By 
                     Connection 
                     (3.x-4.x) 

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