3.3.4.19 Server Application Queries a TreeConnect
The calling application provides GlobalTreeConnectId as an identifier for the tree connect. The server MUST enumerate all session entries in GlobalSessionTable and look up all TreeConnect entries in Session.TreeConnectTable where GlobalTreeConnectId is equal to TreeConnect.TreeGlobalId. If TreeConnect is found, the server MUST return ServerName and a CONNECT_INFO_1 structure as specified in [MS-SRVS] section 2.2.4.2 with the following values set and return STATUS_SUCCESS to the calling application.
Output Parameters |
SMB2 TreeConnect Properties |
---|---|
coni1_id |
TreeConnect.TreeGlobalId |
coni1_type |
TreeConnect.Share.Type |
coni1_num_opens |
TreeConnect.OpenCount |
coni1_num_users |
1 |
coni1_time |
Current time minus TreeConnect.CreationTime, in seconds. |
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.