Category : C Source Code
Archive   : SC3X02.ZIP
Filename : CUSEFILE.DOC

 
Output of file : CUSEFILE.DOC contained in archive : SC3X02.ZIP





Get Connections Using A File

This call returns all logical connections using the file specified
by the Volume Number and Directory Entry Number (Sequence Number).
If only a path is available for the file, the Directory Entry Number
can be obatined by calling the ConvertPathToDirectoryEntry function.

Function 23 (17h)

Request Buffer

Offset Request Packet Contents Bytes Remarks
------ --------------------------- ----- -------
0 Sub-function Structure Len 2 Length
2 236 (ECh) 1
3 Data Stream Type 1
4 Volume Number 1
5 Directory Entry Number 4
9 Last Record Seen 2

Reply Buffer

Offset Request Packet Contents Bytes Remarks
------ --------------------------- ----- -------
0 Next Request Record 2
2 Use Count 2
4 Open Count 2
6 Open For Read Count 2
8 Open For Write Count 2
10 Deny Read Count 2
12 Deny Write Count 2
14 Locked 1
15 Data Stream Type 1
16 Number Of Records 2 Max 70
18 Connection Number 1 2 .
20 Task Number 1 2 .
22 Lock Type 1 1 .
23 Access Flag 1 1 Repeats Number
24 Lock Flag 1 1 Of Record Times
. . . .
. . . .
. Connection Number n 2 Where n is one
. Task Number n 2 of the connections
. Lock Type n 1 using the file
. Access Flag n 1 .
. Lock Flag n 1 .
. . . .

The Data Stream Type determines the data space of the specified
entry.

Volume Number is the number of the volume where the file resides.

Directory Entry is the files entry or sequence number in the file
system.

Last Record Seen is the last connnection number for which information
was returned. This should be set to zero on the first iteration of
this call. If more than 70 connections hold the file open, this
filed should be set to the value of nextRequestRecord from the Reply
Buffer.

Reply Buffer values are as documented in the NetWare System Calls -
DOS, version 1.00. The only exception is the Data Stream Type, which
is documented above.