DnsWriteQuestionToBuffer_UTF8 函数 (windns.h)
DnsWriteQuestionToBuffer 函数类型创建 DNS 查询消息并将其存储在DNS_MESSAGE_BUFFER结构中。 与许多 DNS 函数一样, DnsWriteQuestionToBuffer 函数类型以多种形式实现,以促进不同的字符编码。 根据涉及的字符编码,使用以下函数之一:
- Unicode 编码) 的 DnsWriteQuestionToBuffer_W (_W
- UTF-8 编码) 的 DnsWriteQuestionToBuffer_UTF8 (_UTF8
语法
BOOL DnsWriteQuestionToBuffer_UTF8(
[in, out] PDNS_MESSAGE_BUFFER pDnsBuffer,
[in, out] PDWORD pdwBufferSize,
[in] PCSTR pszName,
[in] WORD wType,
[in] WORD Xid,
[in] BOOL fRecursionDesired
);
参数
[in, out] pDnsBuffer
指向包含存储在缓冲区中的 DNS 查询消息 的 DNS_MESSAGE_BUFFER 结构的指针。
[in, out] pdwBufferSize
分配给存储 pDnsBuffer 的缓冲区的大小(以字节为单位)。 如果缓冲区大小不足以包含消息,则返回 FALSE,pdwBufferSize 包含所需的最小缓冲区大小。
[in] pszName
指向表示所查询记录集所有者名称的字符串的指针。
[in] wType
一个表示 RR DNS 记录类型的 值。 wType 确定 数据的格式。 例如,如果 wType 的值 DNS_TYPE_A,则 data 的数据类型 DNS_A_DATA。
[in] Xid
一个 指定唯一 DNS 查询标识符的 值。
[in] fRecursionDesired
一个 BOOL,指定 DNS 名称服务器是否应使用递归名称查询。 设置为 TRUE 可请求递归名称查询, 设置为 FALSE 可请求迭代名称查询。
返回值
成功执行后返回 TRUE ,否则 返回 FALSE。
注解
可以在 Windns.h 中找到 以下DnsWriteQuestionToBuffer_UTF8 声明。
BOOL
WINAPI
DnsWriteQuestionToBuffer_UTF8(
__inout PDNS_MESSAGE_BUFFER pDnsBuffer,
__inout PDWORD pdwBufferSize,
__in PCSTR pszName,
__in WORD wType,
__in WORD Xid,
__in BOOL fRecursionDesired
);
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | windns.h |
Library | Dnsapi.lib |
DLL | Dnsapi.dll |