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

另请参阅

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery