NWScanOpenFilesByConn2(3nw)


NWScanOpenFilesByConn2 -- scans information about files opened by connection

Synopsis

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

NWCCODE N_API NWScanOpenFilesByConn2 (NWCONN_HANDLE conn, NWCONN_NUM connNum, pnint16 iterHandle, OPEN_FILE_CONN_CTRL N_FAR * openCtrl, OPEN_FILE_CONN N_FAR * openFile);

Description

The parameters are as follows:

conn
(IN) Specifies NetWare server connection handle.

connNum
(IN) Specifies the connection number of the logged-in object to be scanned.

iterHandle
(IN/OUT) Points to the next record to be scanned.

openCtrl
(OUT) Points to OPEN_FILE_CONN_CTRL.

openFile
(OUT) Points to OPEN_FILE_CONN.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x88FF
Scan Completed

0x89C6
NO_CONSOLE_PRIVILEGES

0x89FD
BAD_STATION_NUMBER

Notices

The client must have console operator rights to call NWScanOpenFilesByConn2.

iterHandle should point to 0 initially. Upon each subsequent call, it returns with the number of the next record to be scanned. iterHandle points to -1 upon completion. It should not be changed during the scan.

OPEN_FILE_CONN_CTRL is used internally and should not be written to.

parent and forkCount in OPEN_FILE_CONN are not set by 2.x and are filled with 0xFF. In 2.x, nameSpace is always set to 0.

Services

File Systems

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 219 Get Connection's Open Files (2.x)
0x2222 23 235 Get Connection's Open Files (3.x-4.x)

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   219   Get 
                     Connection's 
                     Open Files 
                     (2.x) 
 0x2222   23   235   Get 
                     Connection's 
                     Open Files 
                     (3.x-4.x) 

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