Share via

3.5.4.3.7 DsrGetDcSiteCoverageW (Opnum 38)

  • Article

The DsrGetDcSiteCoverageW method SHOULD<167> return a list of sites covered by a domain controller. Site coverage is detailed in [MS-ADTS] section 6.1.1.2.2. 

 NET_API_STATUS DsrGetDcSiteCoverageW(
   [in, unique, string] LOGONSRV_HANDLE ServerName,
   [out] PNL_SITE_NAME_ARRAY* SiteNames
 );

ServerName: The custom binding handle (defined in section 3.5.4.1) that represents the connection to a DC.

SiteNames: A pointer to an NL_SITE_NAME_ARRAY structure (section 2.2.1.2.2) that contains an array of site name strings.

Return Values: The method returns 0x00000000 on success; otherwise, it returns a nonzero error code.

This method returns errors based on Common Error Processing Rules A and B, specified in section 3.

The server MUST return all the sites for which the DC publishes site-specific DNS SRV records ([MS-ADTS] section 6.3.2.3).