dnsQueryConfig 函数 (windns.h)
通过 DnsQueryConfig 函数,应用程序程序员可以查询本地计算机或特定适配器的配置。
语法
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
);
参数
[in] Config
一个 DNS_CONFIG_TYPE 值,该值指定要查询的信息的配置类型。
[in] Flag
一个 值,该值指定是否为配置信息分配内存。 将 标志 设置为 DNS_CONFIG_FLAG_ALLOC 以分配内存;否则,将其设置为 0。
注意 使用 LocalFree 释放分配的内存。
[in, optional] pwsAdapterName
指向字符串的指针,该字符串表示运行查询所针对的适配器名称。
[in, optional] pReserved
保留供将来使用。
[out] pBuffer
指向接收查询响应的缓冲区的指针。 下表显示了每个 Config 参数值的缓冲区的数据类型。
Config 参数 | 缓冲区的数据类型 |
---|---|
DnsConfigPrimaryDomainName_W | PWCHAR |
DnsConfigPrimaryDomainName_A | PCHAR |
DnsConfigPrimaryDomainName_UTF8 | PCHAR |
DnsConfigAdapterDomainName_W | 未实现 |
DnsConfigAdapterDomainName_A | 未实现 |
DnsConfigAdapterDomainName_UTF8 | 未实现 |
DnsConfigDnsServerList | IP4_ARRAY |
DnsConfigSearchList | 未实现 |
DnsConfigAdapterInfo | 未实现 |
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
缓冲区的长度(以字节为单位)。 如果提供的缓冲区不足,则返回错误, 并且 pBufferLength 包含所需的最小缓冲区大小。 如果 Flag 设置为 TRUE,则忽略输入。
返回值
成功完成后返回成功确认。 否则,将返回 Winerror.h 中定义的相应 DNS 特定错误代码。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | windns.h |
Library | Dnsapi.lib |
DLL | Dnsapi.dll |