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
指向接收查询响应的缓冲区的指针。 下表显示了每个 配置 参数值的缓冲区数据类型。
配置 参数 | 缓冲区的数据类型 |
---|---|
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 包含所需的最小缓冲区大小。 如果 标志 设置为 TRUE,则忽略输入。
返回值
返回成功完成后的成功确认。 否则,返回 Winerror.h 中定义的相应 DNS 特定错误代码。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | 窗户 |
标头 | windns.h |
库 | Dnsapi.lib |
DLL | Dnsapi.dll |