Share via

3.5.4.3.8 DsrAddressToSiteNamesW (Opnum 33)

  • Article

The DsrAddressToSiteNamesW method SHOULD<168> 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 6.1.1.2.2.1 and 6.1.1.2.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
 );

ComputerName: The custom binding handle (section 3.5.4.1) 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 2.2.1.2.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 2.2.1.2.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 6.1.1.2.2.1.

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

Return Value/Code

Description

0x00000008

ERROR_NOT_ENOUGH_MEMORY

Not enough storage is available to process this command.

0x00000057

ERROR_INVALID_PARAMETER

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 6.1.1.2.2.2.1).