通过

DnsWriteQuestionToBuffer_UTF8函数 （windns.h）

  • 项目

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

  • DnsWriteQuestionToBuffer_W （Unicode 编码_W）
  • DnsWriteQuestionToBuffer_UTF8 （UTF-8 编码的_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，则 数据 的数据类型 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 [仅限桌面应用]
目标平台 窗户
标头 windns.h
库 Dnsapi.lib
DLL Dnsapi.dll

另请参阅

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery