NWScanLogicalLocksByConn

Scans for all logical record locks in a specified connection

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Synchronization

Syntax

  #include <nwsync.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY( NWCCODE )NWScanLogicalLocksByConn  ( 
     NWCONN_HANDLE                conn,  
     NWCONN_NUM                   connNum,  
     pnint16                      iterHandle,  
     CONN_LOGICAL_LOCK  N_FAR    *logicalLock,  
     CONN_LOGICAL_LOCKS  N_FAR   *logicalLocks);

Delphi Syntax

  uses calwin32 
   
  Function NWScanLogicalLocksByConn 
    (conn : NWCONN_HANDLE; 
     connNum : NWCONN_NUM; 
     iterHandle : pnint16; 
     Var logicalLock : CONN_LOGICAL_LOCK; 
     Var logicalLocks : CONN_LOGICAL_LOCKS 
  ) : NWCCODE;

Parameters

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

These are common return values; see Return Values (NDK: Connection, Message, and NCP Extensions) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

0x89C6

NO_CONSOLE_PRIVILEGES

0x89FD

BAD_STATION_NUMBER

0x88FF

Scan Completed

Remarks

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.

NCP Calls