次の方法で共有

DnsWriteQuestionToBuffer_W関数 (windns.h)

  • [アーティクル]

DnsWriteQuestionToBuffer 関数型は、DNS クエリ メッセージを作成し、DNS_MESSAGE_BUFFER 構造に格納します。 多くの DNS 関数と同様に、DnsWriteQuestionToBuffer 関数型は、さまざまな文字エンコードを容易にするために複数の形式で実装されています。 関連する文字エンコードに基づいて、次のいずれかの関数を使用します。

  • DnsWriteQuestionToBuffer_W (Unicode エンコードの_W)
  • DnsWriteQuestionToBuffer_UTF8 (UTF-8 エンコードの_UTF8)
DnsWriteQuestionToBuffer 関数型をサフィックス (_Wまたは_UTF8) なしで使用すると、コンパイラ エラーが発生します。

構文

BOOL DnsWriteQuestionToBuffer_W(
  [in, out] PDNS_MESSAGE_BUFFER pDnsBuffer,
  [in, out] PDWORD              pdwBufferSize,
  [in]      PCWSTR              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
    );

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー windns.h
ライブラリ Dnsapi.lib
DLL Dnsapi.dll

関連項目

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery