windns.h 标头
域名系统（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_A_DATA DNS_A_DATA结构表示 RFC 1035 第 3.4.1 节中指定的 DNS 地址 （A） 记录。 |
|
DNS_AAAA_DATA DNS_AAAA_DATA结构表示 RFC 3596 中指定的 DNS IPv6 （AAAA） 记录。 |
|
DNS_ADDR DNS_ADDR结构存储 IPv4 或 IPv6 地址。 |
|
DNS_ADDR_ARRAY 存储 IPv4 或 IPv6 地址的数组。 |
|
DNS_APPLICATION_SETTINGS 表示每个应用程序 DNS 设置。 |
|
DNS_ATMA_DATA DNS_ATMA_DATA结构表示 DNS ATM 地址（ATMA）资源记录（RR）。 |
|
DNS_CUSTOM_SERVER 表示 DNS 自定义服务器。 DNS_CUSTOM_SERVER 对象通过 DNS_QUERY_REQUEST3 结构传递给 DnsQueryEx。 |
|
DNS_DHCID_DATA 表示 RFC 4701 第 3 节中指定的 DNS 动态主机配置协议信息（DHCID）资源记录（RR）。 |
|
DNS_DS_DATA 表示 RFC 4034 第 2 节中指定的 DS 资源记录（RR），用于验证DNS_DNSKEY_DATA的内容。 |
|
DNS_HEADER DNS_HEADER结构包含发送 RFC 1035 第 4.1.1 节中指定的 DNS 消息时使用的 DNS 标头信息。 |
|
DNS_KEY_DATA DNS_KEY_DATA结构表示 RFC 3445 中指定的 DNS 密钥（KEY）资源记录（RR）。 |
|
DNS_LOC_DATA DNS_LOC_DATA结构表示 RFC 1876 中指定的 DNS 位置（LOC）资源记录（RR）。 |
|
DNS_MESSAGE_BUFFER DNS_MESSAGE_BUFFER结构存储 DNS 查询的消息信息。 |
|
DNS_MINFO_DATAA DNS_MINFO_DATA结构表示 RFC 1035 第 3.3.7 节中指定的 DNS 邮件信息（MINFO）记录。 （ANSI） |
|
DNS_MINFO_DATAW DNS_MINFO_DATA结构表示 RFC 1035 第 3.3.7 节中指定的 DNS 邮件信息（MINFO）记录。 （Unicode） |
|
DNS_MX_DATAA DNS_MX_DATA结构表示 RFC 1035 第 3.3.9 节中指定的 DNS 邮件交换器（MX）记录。 （ANSI） |
|
DNS_MX_DATAW DNS_MX_DATA结构表示 RFC 1035 第 3.3.9 节中指定的 DNS 邮件交换器（MX）记录。 （Unicode） |
|
DNS_NAPTR_DATAA DNS_NAPTR_DATA结构表示 RFC 2915 中指定的命名颁发机构指针（NAPTR）DNS 资源记录（RR）。 （ANSI） |
|
DNS_NAPTR_DATAW DNS_NAPTR_DATA结构表示 RFC 2915 中指定的命名颁发机构指针（NAPTR）DNS 资源记录（RR）。 （Unicode） |
|
DNS_NSEC_DATAA 表示 RFC 4034 第 4 节中指定的 NSEC 资源记录（RR）。 （ANSI） |
|
DNS_NSEC_DATAW 表示 RFC 4034 第 4 节中指定的 NSEC 资源记录（RR）。 （Unicode） |
|
DNS_NULL_DATA DNS_NULL_DATA结构表示 RFC 1035 第 3.3.10 节中指定的 DNS 资源记录的 NULL 数据。 |
|
DNS_NXT_DATAA DNS_NXT_DATA结构表示 RFC 2535 第 5 节中指定的 DNS 下一个 （NXT） 资源记录 （RR）。 （ANSI） |
|
DNS_NXT_DATAW DNS_NXT_DATA结构表示 RFC 2535 第 5 节中指定的 DNS 下一个 （NXT） 资源记录 （RR）。 （Unicode） |
|
DNS_OPT_DATA 表示 RFC 2671 第 4 节中指定的 DNS 选项（OPT）资源记录（RR）。 |
|
DNS_PROXY_INFORMATION 包含 DNS 服务器名称解析策略表的代理信息。 |
|
DNS_PTR_DATAA DNS_PTR_DATA结构表示 RFC 1035 第 3.3.12 节中指定的 DNS 指针（PTR）记录。 （ANSI） |
|
DNS_PTR_DATAW DNS_PTR_DATA结构表示 RFC 1035 第 3.3.12 节中指定的 DNS 指针（PTR）记录。 （Unicode） |
|
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_RECORD_FLAGS DNS_RECORD_FLAGS结构用于设置DNS_RECORD结构中使用的标志。 |
|
DNS_RECORDA 存储 DNS 资源记录（RR）。 （ANSI） |
|
DNS_RECORDW 存储 DNS 资源记录（RR）。 （Unicode） |
|
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_SIG_DATAA 结构表示 RFC 4034 中指定的 DNS 安全扩展插件（DNSSEC）加密签名（SIG）资源记录（RR）。 （ANSI） |
|
DNS_SIG_DATAW 结构表示 RFC 4034 中指定的 DNS 安全扩展插件（DNSSEC）加密签名（SIG）资源记录（RR）。 （Unicode） |
|
DNS_SOA_DATAA DNS_SOA_DATA结构表示 RFC 1035 第 3.3.13 节中指定的 DNS 颁发机构（SOA）记录。 （ANSI） |
|
DNS_SOA_DATAW DNS_SOA_DATA结构表示 RFC 1035 第 3.3.13 节中指定的 DNS 颁发机构（SOA）记录。 （Unicode） |
|
DNS_SRV_DATAA DNS_SRV_DATA结构表示 RFC 2782 中指定的 DNS 服务（SRV）记录。 （ANSI） |
|
DNS_SRV_DATAW DNS_SRV_DATA结构表示 RFC 2782 中指定的 DNS 服务（SRV）记录。 （Unicode） |
|
DNS_TKEY_DATAA DNS_TKEY_DATA结构表示 DNS TKEY 资源记录，用于在 DNS 解析程序与服务器之间建立和删除算法的共享密钥，如 RFC 2930 中指定的。 （ANSI） |
|
DNS_TKEY_DATAW DNS_TKEY_DATA结构表示 DNS TKEY 资源记录，用于在 DNS 解析程序与服务器之间建立和删除算法的共享密钥，如 RFC 2930 中指定的。 （Unicode） |
|
DNS_TSIG_DATAA DNS_TSIG_DATA结构表示 RFC 2845 和 RFC 3645 中指定的密钥事务身份验证（TSIG）资源记录（RR）。 （ANSI） |
|
DNS_TSIG_DATAW DNS_TSIG_DATA结构表示 RFC 2845 和 RFC 3645 中指定的密钥事务身份验证（TSIG）资源记录（RR）。 （Unicode） |
|
DNS_TXT_DATAA DNS_TXT_DATA结构表示 RFC 1035 第 3.3.14 节中指定的 DNS 文本（TXT）记录。 （ANSI） |
|
DNS_TXT_DATAW DNS_TXT_DATA结构表示 RFC 1035 第 3.3.14 节中指定的 DNS 文本（TXT）记录。 （Unicode） |
|
DNS_WINS_DATA DNS_WINS_DATA结构表示 DNS Windows Internet 名称服务（WINS）记录。 |
|
DNS_WINSR_DATAA DNS_WINSR_DATA结构表示 DNS Windows Internet 名称服务反向查找 （WINSR） 记录。 （ANSI） |
|
DNS_WINSR_DATAW DNS_WINSR_DATA结构表示 DNS Windows Internet 名称服务反向查找 （WINSR） 记录。 （Unicode） |
|
DNS_WIRE_QUESTION DNS_WIRE_QUESTION结构包含 RFC 1035 第 4.1.2 节中指定的 DNS 问题的相关信息。 |
|
DNS_WIRE_RECORD DNS_WIRE_RECORD结构包含 RFC 1035 第 4.1.3 节中指定的 DNS 线路记录的相关信息。 |
|
DNS_WKS_DATA DNS_WKS_DATA结构表示 RFC 1035 第 3.4.2 节中指定的 DNS 已知服务（WKS）记录。 |
|
IP4_ARRAY IP4_ARRAY结构存储 IPv4 地址数组。 |
|
IP6_ADDRESS IP6_ADDRESS结构存储 IPv6 地址。 （IP6_ADDRESS） |
|
MDNS_QUERY_HANDLE 包含与正在进行的 MDNS 查询相关的信息。 应用程序不得修改其内容。 |
|
MDNS_QUERY_REQUEST 包含执行 mDNS 查询所需的信息。 |
枚举
|
DNS_CHARSET DNS_CHARSET枚举指定使用的字符集。 |
|
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结构中的代理信息类型。 |
|
DNS_SECTION DNS_SECTION枚举用于记录标志，并用作 DNS 线路消息标头节计数的索引。 |