DnsWriteQuestionToBuffer_UTF8函式 （windns.h）

DnsWriteQuestionToBuffer 函式類型會建立 DNS 查詢訊息，並將其儲存在 DNS_MESSAGE_BUFFER 結構中。 和許多 DNS 函式一樣，DnsWriteQuestionToBuffer 函式類型是以多個形式實作，以利不同的字元編碼。 根據所涉及的字元編碼方式，使用下列其中一個函式：

• DnsWriteQuestionToBuffer_W （Unicode 編碼的_W）
• DnsWriteQuestionToBuffer_UTF8 （UTF-8 編碼的_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_MESSAGE_BUFFER 結構的指標，其中包含儲存在緩衝區中的 DNS 查詢訊息。

[in, out] pdwBufferSize

設定用來儲存 pDnsBuffer 之緩衝區的大小，以位元組為單位，。 如果緩衝區大小不足以包含訊息，則會傳回 FALSE，pdwBufferSize 包含所需的最小緩衝區大小。

[in] pszName

字串的指標，表示所查詢之記錄集的擁有者名稱。

[in] wType

值，表示 RR DNS 記錄類型。 wType 會決定 Data的格式。 例如，如果 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
    );

要求

另請參閱

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery