DnsWriteQuestionToBuffer_W Funktion (windns.h)

Artikel
11/08/2024

Der DnsWriteQuestionToBuffer Funktionstyp erstellt eine DNS-Abfragenachricht und speichert sie in einer DNS_MESSAGE_BUFFER Struktur. Wie viele DNS-Funktionen wird der DnsWriteQuestionToBuffer Funktionstyp in mehreren Formen implementiert, um die unterschiedliche Zeichencodierung zu vereinfachen. Verwenden Sie basierend auf der verwendeten Zeichencodierung eine der folgenden Funktionen:

DnsWriteQuestionToBuffer_W (_W für Unicode-Codierung)
DnsWriteQuestionToBuffer_UTF8 (_UTF8 für UTF-8-Codierung)

Wenn der DnsWriteQuestionToBuffer Funktionstyp ohne suffix verwendet wird (entweder _W oder _UTF8), tritt ein Compilerfehler auf.

Syntax

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
);

Parameter

[in, out] pDnsBuffer

Ein Zeiger auf eine DNS_MESSAGE_BUFFER Struktur, die eine in einem Puffer gespeicherte DNS-Abfragenachricht enthält.

[in, out] pdwBufferSize

Die Größe des Puffers, der in Bytes zum Speichern pDnsBuffer-zugeordnet ist. Wenn die Puffergröße nicht ausreicht, um die Nachricht zu enthalten, wird FALSE- zurückgegeben und pdwBufferSize enthält die minimale erforderliche Puffergröße.

[in] pszName

Ein Zeiger auf eine Zeichenfolge, die den Namen des Besitzers des Datensatzsatzes darstellt, der abgefragt wird.

[in] wType

Ein Wert, der den RR-DNS-Eintragstypdarstellt. wType- bestimmt das Format Data. Wenn beispielsweise der Wert von wType-DNS_TYPE_Aist, wird der Datentyp DataDNS_A_DATA.

[in] Xid

Ein Wert, der den eindeutigen DNS-Abfragebezeichner angibt.

[in] fRecursionDesired

Ein BOOL, das angibt, ob rekursive Namensabfrage vom DNS-Namensserver verwendet werden soll. Legen Sie auf TRUE- fest, um rekursive Namensabfrage anzufordern, FALSE-, um iterative Namensabfrage anzufordern.

Rückgabewert

Gibt TRUE bei erfolgreicher Ausführung zurück, andernfalls FALSE.

Bemerkungen

Die folgende Deklaration für DnsWriteQuestionToBuffer_UTF8 finden Sie in 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
    );

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	windns.h
Library	Dnsapi.lib
DLL-	Dnsapi.dll

Siehe auch

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery-

Freigeben über