Função DnsExtractRecordsFromMessage_UTF8 (windns.h)

Artigo
03/04/2024

O tipo de função DnsExtractRecordsFromMessage extrai registros de recursos (RR) de uma mensagem DNS e armazena esses registros em uma estrutura de DNS_RECORD . Como muitas funções DNS, o tipo de função DnsExtractRecordsFromMessage é implementado em várias formas para facilitar a codificação de caracteres diferente. Com base na codificação de caracteres envolvida, use uma das seguintes funções:

DnsExtractRecordsFromMessage_W (_W para codificação Unicode)
DnsExtractRecordsFromMessage_UTF8 (_UTF8 para codificação UTF-8)

Se o tipo de função DnsExtractRecordsFromMessage for usado sem seu sufixo (_W ou _UTF8), ocorrerá um erro do compilador.

Sintaxe

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

Parâmetros

[in] pDnsBuffer

Um ponteiro para uma estrutura DNS_MESSAGE_BUFFER que contém a mensagem de resposta DNS.

[in] wMessageLength

O tamanho, em bytes, da mensagem no pDnsBuffer.

[out] ppRecord

Um ponteiro para uma estrutura DNS_RECORD que contém a lista de RRs extraídas. Para liberar esses registros, use a função DnsRecordListFree .

Retornar valor

Retorna a confirmação de êxito após a conclusão bem-sucedida. Caso contrário, retorna o código de erro específico do DNS apropriado, conforme definido em Winerror.h.

Comentários

A função DnsExtractRecordsFromMessage foi projetada para operar em mensagens na ordem de byte do host. Dessa forma, as mensagens recebidas devem ser convertidas da ordem de byte de rede para hospedar a ordem de bytes antes da extração ou antes da retransmissão na rede. Use a macro DNS_BYTE_FLIP_HEADER_COUNTS para alterar a ordenação de bytes.

A declaração a seguir para DnsExtractRecordsFromMessage_UTF8 pode ser encontrada em Windns.h.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	windns.h
Biblioteca	Dnsapi.lib
DLL	Dnsapi.dll