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_A_DATA DNS_A_DATA 结构表示 RFC 1035 第 3.4.1 节中指定的 A) 记录 (DNS 地址。
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结构表示 (RR) (ATMA) 资源记录的 DNS ATM 地址。
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 节中指定的 RR) (DS 资源记录，用于验证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 (中指定的 LOC) 资源记录 (RR) 的 DNS 位置。
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 节中指定的 RR) (NSEC 资源记录。 (ANSI)
DNS_NSEC_DATAW 表示 RFC 4034 第 4 节中指定的 RR) (NSEC 资源记录。 (Unicode)
DNS_NULL_DATA DNS_NULL_DATA 结构表示 RFC 1035 第 3.3.10 节中指定的 DNS 资源记录的 NULL 数据。
DNS_NXT_DATAA DNS_NXT_DATA 结构表示下一个 DNS (NXT) 资源记录 (RFC 2535 第 5 节中指定的 RR) 。 (ANSI)
DNS_NXT_DATAW DNS_NXT_DATA 结构表示下一个 DNS (NXT) 资源记录 (RFC 2535 第 5 节中指定的 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 节中指定的 PTR) 记录 (DNS 指针。 (ANSI)
DNS_PTR_DATAW DNS_PTR_DATA结构表示 RFC 1035 第 3.3.12 节中指定的 PTR) 记录 (DNS 指针。 (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 结构表示 DNS 安全扩展插件 (DNSSEC) 加密签名 (SIG) RFC 4034 中指定的资源记录 (RR) 。 (ANSI)
DNS_SIG_DATAW 结构表示 DNS 安全扩展插件 (DNSSEC) 加密签名 (SIG) RFC 4034 中指定的资源记录 (RR) 。 (Unicode)
DNS_SOA_DATAA DNS_SOA_DATA结构表示 RFC 1035 第 3.3.13 节中指定的颁发机构 (SOA) 记录的 DNS 开始。 (ANSI)
DNS_SOA_DATAW DNS_SOA_DATA结构表示 RFC 1035 第 3.3.13 节中指定的颁发机构 (SOA) 记录的 DNS 开始。 (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 资源记录，该记录用于在 RFC 2930 中指定的 DNS 解析程序与服务器之间建立和删除算法的共享密钥。 (ANSI)
DNS_TKEY_DATAW DNS_TKEY_DATA 结构表示 DNS TKEY 资源记录，该记录用于在 RFC 2930 中指定的 DNS 解析程序与服务器之间建立和删除算法的共享密钥。 (Unicode)
DNS_TSIG_DATAA DNS_TSIG_DATA 结构表示密钥事务身份验证 (TSIG) RFC 2845 和 RFC 3645 中指定的资源记录 (RR) 。 (ANSI)
DNS_TSIG_DATAW DNS_TSIG_DATA 结构表示密钥事务身份验证 (TSIG) RFC 2845 和 RFC 3645 中指定的资源记录 (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 线路消息标头部分计数的索引。