NWScanPhysicalLocksByFile(3nw)


NWScanPhysicalLocksByFile -- scans for record locks in physical file

Synopsis

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

NWCCODE N_API NWScanPhysicalLocksByFile (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, nuint8 dataStream, pnint16 iterHandle, PHYSICAL_LOCK N_FAR * lock, PHYSICAL_LOCKS N_FAR * locks);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle associated with the desired directory path.

path
(IN) Points to a full file path (or a path relative to dirHandle) specifying the file to be checked.

dataStream
(IN) Specifies the data stream to use for scan (for 3.11 and above only).

iterHandle
(IN/OUT) Points to the next record to be scanned; must be set to 0 initially.

lock
(OUT) Points to PHYSICAL_LOCK(optional).

locks
(OUT) Points to PHYSICAL_LOCKS.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x88FF
Scan Completed

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89C6
NO_CONSOLE_PRIVILEGES

0x89FD
BAD_STATION_NUMBER

0x89FF
NO_FILES_FOUND_ERROR

Notices

The client must have console operator rights to call NWScanPhysicalLocksByFile.

iterHandle returns -1 upon completion, and should not be changed during the scan.

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

Services

Synchronization

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 222 Get Physical Record Locks By File (2.x)
0x2222 23 238 Get Physical Record Locks By File (3.x-4.x)
0x2222 23 244 Convert Path to Entry

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   222   Get Physical 
                     Record Locks By 
                     File (2.x) 
 0x2222   23   238   Get Physical 
                     Record Locks By 
                     File (3.x-4.x) 
 0x2222   23   244   Convert Path to 
                     Entry 

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