3.2.4.44 Application Requests Querying DFS Referrals

The application provides the following:

  • ServerName: The name of the server from which to query referrals.

  • UserCredentials: An opaque implementation-specific entity that identifies the credentials to be used when authenticating to the remote server.

  • The maximum response size, in bytes.

  • An input buffer containing the application-provided REQ_GET_DFS_REFERRAL structure specified in [MS-DFSC] section 2.2.2.

The client MUST search for an existing Session and TreeConnect to any share on the server identified by ServerName for the user identified by UserCredentials. If no Session and TreeConnect are found, the client MUST establish a new Session and TreeConnect to IPC$ on the target server, as specified in section 3.2.4.2 using the supplied ServerName and UserCredentials.

The client MUST construct a TRANS2_GET_DFS_REFERRAL Request and MUST set ReferralRequest to the application-provided input buffer.

The client MUST construct a TRANS2_GET_DFS_REFERRAL Request (section 2.2.6.16.1) and MUST set ReferralRequest to the application-provided input buffer. The MaxDataCount field of the SMB_COM_TRANSACTION2 Request (section 2.2.4.46.1) MUST be set to the maximum response size supplied by the caller. The client MUST issue the TRANS2_GET_DFS_REFERRAL Request using the Client.TreeConnect.TreeID of the IPC$ share.