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.