Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

3.5.4.2.6 DsrGetSiteName (Opnum 28)

The DsrGetSiteName method<158> returns the site name for the specified computer that receives this call.

Copy 
NET_API_STATUS DsrGetSiteName(
  [in, unique, string] LOGONSRV_HANDLE ComputerName,
  [out, string] wchar_t** SiteName
);

ComputerName: The custom RPC binding handle (section 3.5.4.1).

SiteName: A null-terminated Unicode string that contains the name of the site in which the computer that receives this call resides.

Return Values: The method returns 0x00000000 (NO_ERROR) on success.

If the computer has been manually configured with a site name, it MUST return the manually configured site name immediately.

Otherwise, the server MUST check whether it is time to dynamically find the computer's site by checking the timer SiteNameTimeout.

  • If the timer is expired, the server MUST locate a domain controller in the domain. The server MAY<159> implement alternate means to locate DCs: for example, a static list in a file, or the two methods detailed in [MS-ADTS] section 7.3.6, "Locate a Domain Controller."

  • The server then populates the SiteName parameter with the NETLOGON_SAM_LOGON_RESPONSE_EX message ([MS-ADTS] section 7.3.1.9) by setting the SiteName parameter to NETLOGON_SAM_LOGON_RESPONSE_EX.ClientSiteName.

If the timer is not yet expired, SiteName MUST be returned immediately.

Did you find this helpful?
(1500 characters remaining)