NWScanLogicalLocksByName

Scans for all record locks in a specified logical name

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) NWScanLogicalLocksByName ( 
     NWCONN_HANDLE         conn,  
     const nstr8 N_FAR    *logicalName,  
     pnint16               iterHandle,  
     LOGICAL_LOCK N_FAR   *logicalLock,  
     LOGICAL_LOCKS N_FAR  *logicalLocks);

Delphi Syntax

  uses calwin32 
   
  Function NWScanLogicalLocksByName 
    (conn : NWCONN_HANDLE; 
     logicalName : pnstr8; 
     iterHandle : pnint16; 
     Var logicalLock : LOGICAL_LOCK; 
     Var logicalLocks : LOGICAL_LOCKS 
  ) : NWCCODE;

Parameters

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

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

0x88FF

Scan Completed

0x8996

SERVER_OUT_OF_MEMORY

0x89C6

NO_CONSOLE_PRIVILEGES

Remarks

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.

NCP Calls