Compartir a través de

Función DnsQueryConfig (windns.h)

  • Artículo

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 Marca en DNS_CONFIG_FLAG_ALLOC para asignar memoria; De lo contrario, establézcalo en 0.

Nota Liberar la memoria asignada con LocalFree.
 

[in, optional] pwsAdapterName

Puntero a una cadena que representa el nombre del adaptador con 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 de parámetro de Config.

parámetro config de 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 marca de 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

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de windns.h
biblioteca de Dnsapi.lib
DLL de Dnsapi.dll

Consulte también

DNS_CONFIG_TYPE

DNS_RECORD

dnsQuery