funzione DnsExtractRecordsFromMessage_UTF8 (windns.h)

Articolo
03/04/2024

Il tipo di funzione DnsExtractRecordsFromMessage estrae i record di risorse (RR) da un messaggio DNS e li archivia in una struttura DNS_RECORD . Come molte funzioni DNS, il tipo di funzione DnsExtractRecordsFromMessage viene implementato in più moduli per facilitare la codifica dei caratteri diversa. In base alla codifica dei caratteri interessata, usare una delle funzioni seguenti:

DnsExtractRecordsFromMessage_W (_W per la codifica Unicode)
DnsExtractRecordsFromMessage_UTF8 (_UTF8 per la codifica UTF-8)

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

Sintassi

DNS_STATUS DnsExtractRecordsFromMessage_UTF8(
  [in]  PDNS_MESSAGE_BUFFER pDnsBuffer,
  [in]  WORD                wMessageLength,
  [out] PDNS_RECORD         *ppRecord
);

Parametri

[in] pDnsBuffer

Puntatore a una struttura di DNS_MESSAGE_BUFFER che contiene il messaggio di risposta DNS.

[in] wMessageLength

Dimensione, in byte, del messaggio in pDnsBuffer.

[out] ppRecord

Puntatore a una struttura DNS_RECORD che contiene l'elenco di RR estratti. Per liberare questi record, usare la funzione DnsRecordListFree .

Valore restituito

Restituisce la conferma dell'esito positivo al completamento. In caso contrario, restituisce il codice di errore specifico del DNS appropriato, come definito in Winerror.h.

Commenti

La funzione DnsExtractRecordsFromMessage è progettata per operare sui messaggi nell'ordine dei byte host. Di conseguenza, i messaggi ricevuti devono essere convertiti dall'ordine dei byte di rete per ospitare l'ordine dei byte prima dell'estrazione o prima della ritrasmissione nella rete. Utilizzare la macro DNS_BYTE_FLIP_HEADER_COUNTS per modificare l'ordinamento dei byte.

La dichiarazione seguente per DnsExtractRecordsFromMessage_UTF8 è disponibile in Windns.h.

DNS_STATUS
WINAPI
DnsExtractRecordsFromMessage_UTF8(
    __in            PDNS_MESSAGE_BUFFER pDnsBuffer,
    __in            WORD                wMessageLength,
    __deref_out     PDNS_RECORD *       ppRecord
    );

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

DnsWriteQuestionToBuffer

Condividi tramite