DnsWriteQuestionToBuffer_W-Funktion (windns.h)

Artikel
03/04/2024

Der DnsWriteQuestionToBuffer-Funktionstyp erstellt eine DNS-Abfragenachricht und speichert sie in einer DNS_MESSAGE_BUFFER-Struktur . Wie viele DNS-Funktionen wird auch der DnsWriteQuestionToBuffer-Funktionstyp in mehreren Formen implementiert, um eine unterschiedliche Zeichencodierung zu ermöglichen. Verwenden Sie basierend auf der betreffenden 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 sein Suffix (entweder _W oder _UTF8) verwendet wird, 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 DNS-Abfragenachricht enthält, die in einem Puffer gespeichert ist.

[in, out] pdwBufferSize

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

[in] pszName

Ein Zeiger auf eine Zeichenfolge, die den Namen des Besitzers des abgefragten Datensatzsatzes darstellt.

[in] wType

Ein Wert, der den RR-DNS-Eintragstyp darstellt. wType bestimmt das Format von Daten. Wenn der Wert von wType beispielsweise DNS_TYPE_A ist, wird der Datentyp von DataDNS_A_DATA.

[in] Xid

Ein Wert, der den eindeutigen DNS-Abfragebezeichner angibt.

[in] fRecursionDesired

Eine BOOL, die angibt, ob die rekursive Namensabfrage vom DNS-Namenserver verwendet werden soll. Legen Sie true fest, um eine rekursive Namensabfrage anzufordern, und auf FALSE , um iterative Namensabfrage anzufordern.

Rückgabewert

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

Hinweise

Die folgende Deklaration für DnsWriteQuestionToBuffer_UTF8 finden Sie unter 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	windns.h
Bibliothek	Dnsapi.lib
DLL	Dnsapi.dll

Weitere Informationen

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

Freigeben über