Función DnsQueryConfig (windns.h)

La función DnsQueryConfig permite a los programadores de aplicaciones consultar la configuración del equipo local o un adaptador específico.

Sintaxis

DNS_STATUS DnsQueryConfig(
  [in]           DNS_CONFIG_TYPE Config,
  [in]           DWORD           Flag,
  [in, optional] PCWSTR          pwsAdapterName,
  [in, optional] PVOID           pReserved,
  [out]          PVOID           pBuffer,
  [in, out]      PDWORD          pBufLen
);

Parámetros

[in] Config

Valor DNS_CONFIG_TYPE que especifica el tipo de configuración de la información que se va a consultar.

[in] Flag

Valor que especifica si se va a asignar memoria para la información de configuración. Establezca Marcaen DNS_CONFIG_FLAG_ALLOC para asignar memoria; de lo contrario, establézcalo en 0.

Nota Libere la memoria asignada con LocalFree.

 

[in, optional] pwsAdapterName

Puntero a una cadena que representa el nombre del adaptador en el que se ejecuta la consulta.

[in, optional] pReserved

Reservado para uso futuro.

[out] pBuffer

Puntero a un búfer que recibe la respuesta de la consulta. En la tabla siguiente se muestra el tipo de datos del búfer para cada uno de los valores del parámetro Config .

Parámetro de configuración	Tipo de datos de búfer
DnsConfigPrimaryDomainName_W	PWCHAR
DnsConfigPrimaryDomainName_A	PCHAR
DnsConfigPrimaryDomainName_UTF8	PCHAR
DnsConfigAdapterDomainName_W	No implementado
DnsConfigAdapterDomainName_A	No implementado
DnsConfigAdapterDomainName_UTF8	No implementado
DnsConfigDnsServerList	IP4_ARRAY
DnsConfigSearchList	No implementado
DnsConfigAdapterInfo	No implementado
DnsConfigPrimaryHostNameRegistrationEnabled	DWORD
DnsConfigAdapterHostNameRegistrationEnabled	DWORD
DnsConfigAddressRegistrationMaxCount	DWORD
DnsConfigHostName_W	PWCHAR
DnsConfigHostName_A	PCHAR
DnsConfigHostName_UTF8	PCHAR
DnsConfigFullHostName_W	PWCHAR
DnsConfigFullHostName_A	PCHAR
DnsConfigFullHostName_UTF8	PCHAR

[in, out] pBufLen

Longitud del búfer, en bytes. Si el búfer proporcionado no es suficiente, se devuelve un error y pBufferLength contiene el tamaño mínimo necesario del búfer. Se omite en la entrada si Flag está establecido en TRUE.

Valor devuelto

Devuelve la confirmación correcta tras la finalización correcta. De lo contrario, devuelve el código de error específico de DNS adecuado, tal como se define en Winerror.h.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	windns.h
Library	Dnsapi.lib
Archivo DLL	Dnsapi.dll

Consulte también

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery