2.2.4.7.1 Client Request Extensions

An SMB_COM_TREE_CONNECT_ANDX request MUST be sent by a client to establish a tree connect to a share. These extensions define new flags (TREE_CONNECT_ANDX_EXTENDED_SIGNATURES and TREE_CONNECT_ANDX_EXTENDED_RESPONSE) in the SMB_Parameters.Words.Flags field that are used to trigger the new behavior defined in this specification. The full field description from [MS-CIFS] is included for completeness. All other fields are as specified in [MS-CIFS] section 2.2.4.55.1.

 SMB_Parameters
   {
   UCHAR  WordCount;
   Words
     {
     UCHAR  AndXCommand;
     UCHAR  AndXReserved;
     USHORT AndXOffset;
     USHORT Flags;
     USHORT PasswordLength;
     }
   }
 SMB_Data
   {
   USHORT ByteCount;
   Bytes
     {
     UCHAR      Password[PasswordLength];
     UCHAR      Pad[];
     SMB_STRING Path;
     OEM_STRING Service;
     }
   }

SMB_Parameters

Words (8 bytes):


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

AndXCommand

AndXReserved

AndXOffset

Flags

PasswordLength

Flags (2 bytes): A set of options that modify the SMB_COM_TREE_CONNECT_ANDX request. The entire flag set is given here with its symbolic constants. Any combination of the following flags is valid. Any values not given as follows are considered reserved.

Name & bitmask

Meaning

TREE_CONNECT_ANDX_DISCONNECT_TID

0x0001

If set and SMB_Header.TID is valid, the tree connect specified by the TID in the SMB header of the request SHOULD be disconnected when the server sends the response. If this tree disconnect fails, then the error SHOULD be ignored.

If set and TID is invalid, the server MUST ignore this bit.

TREE_CONNECT_ANDX_EXTENDED_SIGNATURES

0x0004

If set, then the client is requesting signing key protection, as specified in sections 3.2.4.2.5 and 3.2.5.4.

TREE_CONNECT_ANDX_EXTENDED_RESPONSE

0x0008

If set, then the client is requesting extended information in the SMB_COM_TREE_CONNECT_ANDX response.