通过

DnsWriteQuestionToBuffer_UTF8 函数 (windns.h)

  • 项目

DnsWriteQuestionToBuffer 函数类型创建 DNS 查询消息并将其存储在DNS_MESSAGE_BUFFER结构中。 与许多 DNS 函数一样， DnsWriteQuestionToBuffer 函数类型以多种形式实现，以促进不同的字符编码。 根据涉及的字符编码，使用以下函数之一：

  • Unicode 编码) 的 DnsWriteQuestionToBuffer_W (_W
  • UTF-8 编码) 的 DnsWriteQuestionToBuffer_UTF8 (_UTF8
如果使用 DnsWriteQuestionToBuffer 函数类型时没有其后缀 (_W或_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

另请参阅

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery