126.96.36.199.8 DsrAddressToSiteNamesW (Opnum 33)
The DsrAddressToSiteNamesW method<232> translates 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 188.8.131.52.2.1 and 184.108.40.206.2.2.
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 );
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 220.127.116.11.4) 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 18.104.22.168.2) 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 22.214.171.124.2.1.
Return Values: The method returns 0x00000000 on success; otherwise, it returns a nonzero error code.<233>
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 126.96.36.199.2.2.1).