DsrAddressToSiteNamesW (Opnum 33)

The DsrAddressToSiteNamesW method SHOULD<154> translate a list of socket addresses into their corresponding site names. For details about the mapping from socket address to subnet/site name, see [MS-ADTS] sections and

 NET_API_STATUS DsrAddressToSiteNamesW(
   [in, unique, string] LOGONSRV_HANDLE ComputerName,
   [in, range(0, 32000)] DWORD EntryCount,
   [in, size_is(EntryCount)] PNL_SOCKET_ADDRESS SocketAddresses,
   [out] PNL_SITE_NAME_ARRAY* SiteNames

ComputerName: The custom binding handle (section that represents the connection to a domain controller.

EntryCount: The number of socket addresses specified in SocketAddresses. The maximum value for EntryCount is 32000. The limit was chosen to prevent clients from being able to force large memory allocations on servers.

SocketAddresses: An array of NL_SOCKET_ADDRESS structures (section that contains socket addresses to translate. The number of addresses specified MUST be equal to EntryCount.

SiteNames: A pointer to an NL_SITE_NAME_ARRAY structure (section that contains a corresponding array of site names. The number of entries returned is equal to EntryCount. The fields of an entry are set to zero if the corresponding socket address does not map to any site, or if the address family of the socket address is not IPV4 or IPV6. The mapping of IP addresses to sites is specified in [MS-ADTS] section

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

Return Value/Code




Not enough storage is available to process this command.



One of the parameters is invalid. This error value is returned if the value of EntryCount passed to DsrAddressToSiteNamesW is zero.

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

The server MUST return the site names that correspond to the SocketAddresses parameter by using the method specified for IP address and site/subnet mapping ([MS-ADTS] section