DnsGetServerAddress Function  
 
INT WINAPI DnsGetServerAddress(
  HCLIENT hClient,  
  INT nServer,  
  LPTSTR lpszAddress,  
  INT nMaxLength  
);

The DnsGetServerAddress function returns the address of the registered nameserver.

Parameters

hClient
Handle the client session.
nServer
The index into the client's nameserver table. This index is the same value that is passed to the DnsRegisterServer function when the nameserver is registered.
lpszAddress
A null-terminated string buffer that will contain the address of the nameserver when the function returns. This buffer should be large enough to store both IPv4 and IPv6 addresses, with a minimum length of 40 characters. If this parameter is NULL, it will be ignored.
nMaxLength
The maximum number of characters that can be copied into the string buffer. If this value is zero, the lpszAddress parameter will be ignored and the function will return the length of the address.

Return Value

If the function succeeds, the return value is the length of the address, not including the terminating null character. If the function fails, the return value is DNS_ERROR. To get extended error information, call DnsGetLastError.

Requirements

Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Import Library: csdnsv11.lib
Unicode: Implemented as Unicode and ANSI versions

See Also

DnsCreateHandle, DnsGetResolverAddress, DnsGetServerPort, DnsRegisterServer, DnsUnregisterServer