windns.h 标头

域名系统（DNS）使用此标头。 有关详细信息，请参阅：

• 域名系统（DNS）

windns.h 包含以下编程接口：

功能

DnsAcquireContextHandle_A DnsAcquireContextHandle 函数类型获取一组凭据的上下文句柄。 （ANSI）
DnsAcquireContextHandle_W DnsAcquireContextHandle 函数类型获取一组凭据的上下文句柄。 （Unicode）
DnsCancelQuery DnsCancelQuery 函数可用于取消对 DNS 命名空间的挂起查询。
DnsCancelQueryRaw 取消通过调用 DnsQueryRaw 发起的查询。
DnsExtractRecordsFromMessage_UTF8 DnsExtractRecordsFromMessage 函数类型从 DNS 消息中提取资源记录（RR），并将这些记录存储在DNS_RECORD结构中。 （DnsExtractRecordsFromMessage_UTF8）
DnsExtractRecordsFromMessage_W DnsExtractRecordsFromMessage 函数类型从 DNS 消息中提取资源记录（RR），并将这些记录存储在DNS_RECORD结构中。 （DnsExtractRecordsFromMessage_W）
DnsFree 释放为使用 DnsQuery 函数获取的 DNS 记录分配的内存。
DnsFreeCustomServers 释放从上一次调用 DnsGetApplicationSettings返回的自定义服务器的数组。
DnsFreeProxyName 释放为使用 DnsGetProxyInformation 函数获取的 DNS_PROXY_INFORMATION 结构的 proxyName 成员分配的内存。
DnsGetApplicationSettings 检索每个应用程序 DNS 设置。
DnsGetProxyInformation DnsGetProxyInformation 函数返回 DNS 服务器名称解析策略表的代理信息。
DnsModifyRecordsInSet_A 函数添加、修改或删除以前可能已注册到 DNS 服务器的资源记录（RR）集。 （DnsModifyRecordsInSet_A）
DnsModifyRecordsInSet_UTF8 函数添加、修改或删除以前可能已注册到 DNS 服务器的资源记录（RR）集。 （DnsModifyRecordsInSet_UTF8）
DnsModifyRecordsInSet_W 函数添加、修改或删除以前可能已注册到 DNS 服务器的资源记录（RR）集。 （DnsModifyRecordsInSet_W）
DnsNameCompare DnsNameCompare 函数比较两个 DNS 名称。 （DnsNameCompare_UTF8）
DnsNameCompare_A DnsNameCompare 函数比较两个 DNS 名称。 （DnsNameCompare_A）
DnsNameCompare_W DnsNameCompare 函数比较两个 DNS 名称。 （DnsNameCompare_W）
DnsQuery_A DNS 命名空间的通用查询接口，并向应用程序开发人员提供 DNS 查询解析接口。 （DnsQuery_A）
DnsQuery_UTF8 DNS 命名空间的通用查询接口，并向应用程序开发人员提供 DNS 查询解析接口。 （DnsQuery_UTF8）
DnsQuery_W DNS 命名空间的通用查询接口，并向应用程序开发人员提供 DNS 查询解析接口。 （DnsQuery_W）
DnsQueryConfig DnsQueryConfig 函数使应用程序程序员能够查询本地计算机或特定适配器的配置。
DnsQueryEx DNS 命名空间的异步泛型查询接口，并为应用程序开发人员提供 DNS 查询解析接口。
DnsQueryRaw 使你能够执行接受包含 DNS 查询的原始数据包或查询名称和类型的 DNS 查询。
DnsQueryRawResultFree 释放分配给DNS_QUERY_RAW_RESULT结构对象的内存。
DnsRecordCompare DnsRecordCompare 函数比较两个 DNS 资源记录（RR）。
DnsRecordCopyEx DnsRecordCopyEx 函数创建指定资源记录的副本（RR）。 DnsRecordCopyEx 函数还可以在复制操作期间转换字符编码。
DnsRecordListFree 释放为使用 DnsQuery 函数获取的 DNS 记录分配的内存。
DnsRecordSetCompare DnsRecordSetCompare 函数比较两个 RR 集。
DnsRecordSetCopyEx DnsRecordSetCopyEx 函数创建指定资源记录集的副本。 DnsRecordSetCopyEx 函数还可以在复制操作期间转换字符编码。
DnsRecordSetDetach DnsRecordSetDetach 函数从指定的 DNS 记录列表中分离第一个记录集。
DnsReleaseContextHandle DnsReleaseContextHandle 函数释放用于存储特定帐户凭据的内存。
DnsReplaceRecordSetA 替换现有资源记录 （RR） 集。 （DnsReplaceRecordSetA）
DnsReplaceRecordSetUTF8 替换现有资源记录 （RR） 集。 （DnsReplaceRecordSetUTF8）
DnsReplaceRecordSetW 替换现有资源记录 （RR） 集。 （DnsReplaceRecordSetW）
DnsServiceBrowse 用于为本地网络上运行的服务启动 DNS-SD 发现。
DnsServiceBrowseCancel 用于取消正在运行的 DNS-SD 发现查询。
DnsServiceConstructInstance 用于根据描述它的数据生成 DNS_SERVICE_INSTANCE 结构。
DnsServiceCopyInstance 用于复制 DNS_SERVICE_INSTANCE 结构。
DnsServiceDeRegister 用于删除已注册的服务。
DnsServiceFreeInstance 用于释放与 DNS_SERVICE_INSTANCE 结构关联的资源。
DnsServiceRegister 用于在此设备上注册可发现的服务。 （DnsServiceRegister）
DnsServiceRegisterCancel 用于取消挂起的注册操作。
DnsServiceResolve 用于获取有关在本地网络上播发的服务的详细信息。
DnsServiceResolveCancel 用于取消正在运行的 DNS-SD 解析查询。
DnsSetApplicationSettings 配置每个应用程序 DNS 设置。 这包括将每个应用程序 DNS 服务器设置为回退到系统配置的服务器或独占服务器的功能。
DnsStartMulticastQuery 用于在此设备上注册可发现的服务。 （DnsStartMulticastQuery）
DnsStopMulticastQuery 用于停止正在运行的 DnsStartMulticastQuery 操作。
DnsValidateName DnsValidateName 宏 （windns.h） 函数验证指定 DNS 名称的状态。
DnsValidateName_A DnsValidateName 函数验证指定 DNS 名称的状态。 （DnsValidateName_A）
DnsValidateName_UTF8 DnsValidateName_UTF8函数 （windns.h） 函数验证指定 DNS 名称的状态。
DnsValidateName_W DnsValidateName 函数验证指定 DNS 名称的状态。 （DnsValidateName_W）
DnsValidateServerStatus DnsValidateServerStatus 函数将 IP 地址验证为合适的 DNS 服务器。
DnsWriteQuestionToBuffer_UTF8 DnsWriteQuestionToBuffer 函数类型创建 DNS 查询消息并将其存储在DNS_MESSAGE_BUFFER结构中。 （DnsWriteQuestionToBuffer_UTF8）
DnsWriteQuestionToBuffer_W DnsWriteQuestionToBuffer 函数类型创建 DNS 查询消息并将其存储在DNS_MESSAGE_BUFFER结构中。 （DnsWriteQuestionToBuffer_W）

回调函数

DNS_QUERY_COMPLETION_ROUTINE DNS_QUERY_COMPLETION_ROUTINE回调用于异步返回 DNS 查询的结果。
DNS_QUERY_RAW_COMPLETION_ROUTINE 实现的异步回调函数的函数签名。 系统使用通过调用 DnsQueryRaw 发起的查询结果调用实现。
DNS_SERVICE_BROWSE_CALLBACK 用于异步返回 DNS-SD 查询的结果。
DNS_SERVICE_REGISTER_COMPLETE 用于通知应用程序服务注册已完成。
DNS_SERVICE_RESOLVE_COMPLETE 用于异步返回服务解析操作的结果。
MDNS_QUERY_CALLBACK 用于异步返回 mDNS 查询的结果。

结构

DNS_APPLICATION_SETTINGS 表示每个应用程序 DNS 设置。
DNS_PROXY_INFORMATION 包含 DNS 服务器名称解析策略表的代理信息。
DNS_QUERY_CANCEL DNS_QUERY_CANCEL结构可用于取消异步 DNS 查询。
DNS_QUERY_RAW_CANCEL 表示 DNS 原始查询取消句柄。
DNS_QUERY_RAW_REQUEST 表示 DNS 原始查询请求（请参阅 DnsQueryRaw）。
DNS_QUERY_RAW_RESULT 表示 DNS 原始查询结果（请参阅 DNS_QUERY_RAW_COMPLETION_ROUTINE）。
DNS_QUERY_REQUEST DNS_QUERY_REQUEST结构包含对 DnsQueryEx 的调用中使用的 DNS 查询参数。
DNS_QUERY_REQUEST3 包含调用 DnsQueryEx中使用的 DNS 查询参数。
DNS_QUERY_RESULT DNS_QUERY_RESULT结构包含从对 DnsQueryEx 的调用返回的 DNS 查询结果。
DNS_RRSET DNS_RRSET结构包含有关 DNS 资源记录（RR）集的信息。
DNS_SERVICE_BROWSE_REQUEST 包含调用 DnsServiceBrowse中使用的查询参数。
DNS_SERVICE_CANCEL 用于取消异步 DNS-SD 操作。
DNS_SERVICE_INSTANCE 表示在网络上运行的 DNS 服务。
DNS_SERVICE_REGISTER_REQUEST 包含使用 DnsServiceRegister播发服务所需的信息，或停止使用 DnsServiceDeRegister播发服务。
DNS_SERVICE_RESOLVE_REQUEST 包含调用 DnsServiceResolve中使用的查询参数。
DNS_WIRE_QUESTION DNS_WIRE_QUESTION结构包含 RFC 1035 第 4.1.2 节中指定的 DNS 问题的相关信息。
DNS_WIRE_RECORD DNS_WIRE_RECORD结构包含 RFC 1035 第 4.1.3 节中指定的 DNS 线路记录的相关信息。
IP4_ARRAY IP4_ARRAY结构存储 IPv4 地址数组。
MDNS_QUERY_HANDLE 包含与正在进行的 MDNS 查询相关的信息。 应用程序不得修改其内容。
MDNS_QUERY_REQUEST 包含执行 mDNS 查询所需的信息。

枚举

DNS_CONFIG_TYPE DNS_CONFIG_TYPE枚举提供 DNS 配置类型信息。
DNS_FREE_TYPE DNS_FREE_TYPE枚举指定要释放的数据类型。
DNS_NAME_FORMAT DNS_NAME_FORMAT枚举指定 DNS 的名称格式信息。
DNS_PROXY_INFORMATION_TYPE DNS_PROXY_INFORMATION_TYPE枚举定义DNS_PROXY_INFORMATION结构中的代理信息类型。