DnsWriteQuestionToBuffer_UTF8-Funktion (windns.h)

Artikel
03/13/2024

Der Funktionstyp DnsWriteQuestionToBuffer erstellt eine DNS-Abfragenachricht und speichert sie in einer DNS_MESSAGE_BUFFER-Struktur . Wie viele DNS-Funktionen ist auch der Funktionstyp DnsWriteQuestionToBuffer in mehreren Formen implementiert, um unterschiedliche Zeichencodierungen zu ermöglichen. Verwenden Sie basierend auf der beteiligten 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_UTF8(
  [in, out] PDNS_MESSAGE_BUFFER pDnsBuffer,
  [in, out] PDWORD              pdwBufferSize,
  [in]      PCSTR               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, der dem Speichern von pDnsBuffer zugeordnet ist, in Byte. 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 Data. 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

Ein BOOL, der angibt, ob eine rekursive Namensabfrage vom DNS-Namenserver verwendet werden soll. Legen Sie auf TRUE fest, um eine rekursive Namensabfrage anzufordern, false , um eine 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 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
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