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.
[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 |