funzione DnsWriteQuestionToBuffer_UTF8 (windns.h)

Articolo
03/04/2024

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

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

Se il tipo di funzione DnsWriteQuestionToBuffer 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 contenente 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, FALSE viene restituito 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 Dati. Ad esempio, se il valore di wType è DNS_TYPE_A, il tipo di dati di Dati è DNS_A_DATA.

[in] Xid

Valore che specifica l'identificatore di query DNS univoco.

[in] fRecursionDesired

Valore BOOL che specifica se deve essere usata dalla query nome ricorsiva dal server nome DNS. Impostare su TRUE per richiedere una query di nome ricorsivo, FALSE per richiedere una query di nome iterativo.

Valore restituito

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

Commenti

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	Dnsapi.lib
DLL	Dnsapi.dll

Vedi anche

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

Condividi tramite