DnsWriteQuestionToBuffer_UTF8-Funktion (windns.h)
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)
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 |