NWScanPhysicalLocksByConnFile(3nw)


NWScanPhysicalLocksByConnFile -- scans for physical record locks on file

Synopsis

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

NWCCODE N_API NWScanPhysicalLocksByConnFile (NWCONN_HANDLE conn, NWCONN_NUM connNum, NWDIR_HANDLE dirHandle, pnstr8 path, nuint8 dataStream, pnint16 iterHandle, CONN_PHYSICAL_LOCK N_FAR * lock, CONN_PHYSICAL_LOCKS N_FAR * locks);

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.

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. The last item must be a file name.

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

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

lock
(OUT) Points to CONN_PHYSICAL_LOCK.

locks
(OUT) Points to CONN_PHYSICAL_LOCKS.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x88FF
Scan Completed

0x89C6
NO_CONSOLE_PRIVILEGES

0x8996
SERVER_OUT_OF_MEMORY

0x89FD
BAD_STATION_NUMBER

0x89FF
FILE_NAME_ERROR, NO_FILES_FOUND_ERROR

Notices

The client must have console operator rights to call NWScanPhysicalLocksByConnFile.

For 2.x, path cannot be longer than 14 bytes including the NULL character.

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

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

Services

Synchronization

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 221 Get Physical Record Locks By Connection And File (2.x)
0x2222 23 237 Get Physical Record Locks By Connection And File (3.x-4.x)
0x2222 23 244 Convert Path To Entry
0x2222 62 - Scan First

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   221   Get Physical 
                     Record Locks By 
                     Connection And 
                     File (2.x) 
 0x2222   23   237   Get Physical 
                     Record Locks By 
                     Connection And 
                     File (3.x-4.x) 
 0x2222   23   244   Convert Path To 
                     Entry 
 0x2222   62   -     Scan First 

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