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.