2.5.6.3.3 NetShareInfo2 Data Structure

The NetShareInfo2 data structure has the following fields.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

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.