funzione DnsExtractRecordsFromMessage_UTF8 (windns.h)

Articolo
01/16/2025

Il DnsExtractRecordsFromMessage tipo di funzione estrae i record di risorse (RR) da un messaggio DNS e li archivia in una struttura DNS_RECORD. Come molte funzioni DNS, il DnsExtractRecordsFromMessage 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:

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

Se il DnsExtractRecordsFromMessage tipo di funzione viene utilizzato 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 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 richieste pull estratte. 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.

Osservazioni

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 all'ordine dei byte host 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
    );

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

DnsRecordListFree

DnsWriteQuestionToBuffer

Condividi tramite