2.5.6.3.3 NetShareInfo2 Data Structure
The NetShareInfo2 data structure has the following fields.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
NetworkName (13 bytes) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
Pad |
Type |
|||||||||||||||||||||||||||||
|
RemarkOffsetLow |
RemarkOffsetHigh |
||||||||||||||||||||||||||||||
|
Permissions |
MaxUses |
||||||||||||||||||||||||||||||
|
CurrentUses |
PathOffsetLow |
||||||||||||||||||||||||||||||
|
PathOffsetHigh |
Password |
||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
Pad2 |
||||||||||||||||||||||||||||||
NetworkName (13 bytes): A 13-character null-terminated ASCII string that specifies the name of the share. If the name is shorter than 13 bytes, the NetworkName field MUST be filled with null characters up to 13 bytes in length. If the name of the share is longer than 13 bytes, it MUST NOT be included in the enumeration.
Pad (1 byte): SHOULD be set to zero when sent, and MUST be ignored on receipt.
Type (2 bytes): A 16-bit unsigned integer that specifies the type of the share. The possible values for Type are as follows.
-
Value
Meaning
STYPE_DISKTREE
0x0000
Disk directory tree
STYPE_PRINTQ
0x0001
Printer queue
STYPE_DEVICE
0x0002
Communications device
STYPE_IPC
0x0003
Interprocess communication (IPC)
RemarkOffsetLow (2 bytes): A 16-bit unsigned integer that represents the offset, in bytes, from the start of the response to a null-terminated ASCII string allocated in the response block (see section 2.5.11). The string is an optional comment about the share. Before using this value, the RAP client MUST subtract the Converter field specified in section 2.5.2 from the RemarkOffsetLow value, and then use that result as the offset within the response.
RemarkOffsetHigh (2 bytes): Unused. Can be set to any arbitrary value when sent, and MUST be ignored on receipt.
Permissions (2 bytes): Obsolete value representing the access allowed in share-level security scenarios. SHOULD be set to zero when sent, and MUST be ignored on receipt.
MaxUses (2 bytes): The maximum number of users that are allowed to concurrently access this share.
CurrentUses (2 bytes): The current number of users accessing this share.
PathOffsetLow (2 bytes): A 16-bit unsigned integer that represents the offset, in bytes, from the start of the response to a null-terminated ASCII string allocated in the response block (see section 2.5.11) that specifies the local path of the share on the server. Before using this value, the RAP client MUST subtract the Converter field specified in section 2.5.2 from the PathOffsetLow value, and then use that result as the offset within the response.
PathOffsetHigh (2 bytes): Unused. Can be set to any arbitrary value when sent, and MUST be ignored on receipt.
Password (9 bytes): A null-terminated ASCII string containing the password for password-protected shares. This value is only used for legacy share-level security, and SHOULD be set to an empty string.
Pad2 (1 byte): SHOULD be set to zero when sent, and MUST be ignored on receipt.