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

另请参阅

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery