funzione DnsWriteQuestionToBuffer_UTF8 (windns.h)

Articolo
11/08/2024

Il tipo di funzione DnsWriteQuestionToBuffer crea un messaggio di query DNS e lo archivia in una struttura DNS_MESSAGE_BUFFER. Analogamente a molte funzioni DNS, il DnsWriteQuestionToBuffer tipo di funzione viene implementato in più forme per facilitare la codifica dei caratteri diversa. In base alla codifica dei caratteri interessata, usare una delle funzioni seguenti:

DnsWriteQuestionToBuffer_W (_W per la codifica Unicode)
DnsWriteQuestionToBuffer_UTF8 (_UTF8 per la codifica UTF-8)

Se il DnsWriteQuestionToBuffer tipo di funzione viene usato senza il relativo suffisso (_W o _UTF8), si verificherà un errore del compilatore.

Sintassi

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

Parametri

[in, out] pDnsBuffer

Puntatore a una struttura DNS_MESSAGE_BUFFER che contiene un messaggio di query DNS archiviato in un buffer.

[in, out] pdwBufferSize

Dimensioni, in byte, del buffer allocato per archiviare pDnsBuffer. Se le dimensioni del buffer non sono sufficienti per contenere il messaggio, viene restituito FALSE e pdwBufferSize contiene le dimensioni minime necessarie del buffer.

[in] pszName

Puntatore a una stringa che rappresenta il nome del proprietario del set di record sottoposto a query.

[in] wType

Valore che rappresenta il tipo di record DNS RR. wType determina il formato di Data. Ad esempio, se il valore di wType è DNS_TYPE_A, il tipo di dati di Data è DNS_A_DATA.

[in] Xid

Valore che specifica l'identificatore di query DNS univoco.

[in] fRecursionDesired

Valore BOOL che specifica se la query del nome ricorsivo deve essere utilizzata dal server dei nomi DNS. Impostare su TRUE per richiedere una query di nome ricorsivo, FALSE per richiedere una query del nome iterativo.

Valore restituito

Restituisce TRUE al termine dell'esecuzione; in caso contrario, FALSE.

Osservazioni

La dichiarazione seguente per DnsWriteQuestionToBuffer_UTF8 è disponibile 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
    );

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	windns.h
libreria	Dnsapi.lib
dll	Dnsapi.dll

Vedere anche

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

Condividi tramite