3.3.4.15 Server Application Queries a TreeConnect
The calling application MUST provide GlobalTreeConnectId as an identifier for the TreeConnect. The server MUST enumerate all connection entries in Server.ConnectionTable and MUST look up all TreeConnect entries in Server.Connection.TreeConnectTable where GlobalTreeConnectId is equal to TreeConnect.TreeGlobalId. If a TreeConnect is found, the server MUST return ServerName and a CONNECTION_INFO_1 structure ([MS-SRVS] section 2.2.4.2) with the following values set and MUST return STATUS_SUCCESS to the calling application.
Output parameters |
[MS-CIFS] TreeConnect properties |
---|---|
coni1_id |
TreeConnect.TreeGlobalId |
coni1_type |
TreeConnect.Share.ShareType |
coni1_num_opens |
TreeConnect.OpenCount |
coni1_num_users |
0x00000001 |
coni1_time |
Current time minus TreeConnect.CreationTime. |
coni1_username |
TreeConnect.Session.UserName |
coni1_netname |
TreeConnect.Share.Name |
ServerName |
TreeConnect.Share.ServerName |
If no TreeConnect is found, the server MUST return an implementation-dependent error.