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 クエリ メッセージを含む 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

DNS ネーム サーバーで再帰的な名前クエリを使用するかどうかを指定する BOOL。 再帰的な名前クエリを要求する場合は TRUE 、反復的な名前クエリを要求する 場合は FALSE に設定します。

戻り値

正常に実行されると TRUE を返し、それ以外の場合 は FALSE を返します。

注釈

DnsWriteQuestionToBuffer_UTF8の次の宣言は Windns.h にあります。

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