функция DnsExtractRecordsFromMessage_UTF8 (windns.h)

Статья
01/16/2025

Тип функции DnsExtractRecordsFromMessage извлекает записи ресурсов (RR) из сообщения DNS и сохраняет эти записи в структуре DNS_RECORD. Как и многие функции DNS, тип функции DnsExtractRecordsFromMessage реализован в нескольких формах для упрощения разной кодировки символов. В зависимости от используемой кодировки символов используйте одну из следующих функций:

DnsExtractRecordsFromMessage_W (_W для кодировки Юникода)
DnsExtractRecordsFromMessage_UTF8 (_UTF8 для кодировки UTF-8)

Если тип функции DnsExtractRecordsFromMessage используется без суффикса (_W или _UTF8), возникнет ошибка компилятора.

Синтаксис

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

Параметры

[in] pDnsBuffer

Указатель на структуру DNS_MESSAGE_BUFFER, содержащую сообщение ответа DNS.

[in] wMessageLength

Размер сообщения в pDnsBuffer.

[out] ppRecord

Указатель на структуру DNS_RECORD, содержащую список извлеченных RR. Чтобы освободить эти записи, используйте функцию DnsRecordListFree.

Возвращаемое значение

Возвращает подтверждение успешности после успешного завершения. В противном случае возвращает соответствующий код ошибки, зависящий от DNS, как определено в Winerror.h.

Замечания

Функция DnsExtractRecordsFromMessage предназначена для работы с сообщениями в порядке байтов узла. Таким образом, полученные сообщения следует преобразовать из сетевого порядка байтов в порядок размещения байтов перед извлечением или перед повторной передачой в сеть. Используйте макрос DNS_BYTE_FLIP_HEADER_COUNTS для изменения порядка байтов.

Следующее объявление для DnsExtractRecordsFromMessage_UTF8 можно найти в Windns.h.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	windns.h
библиотеки	Dnsapi.lib
DLL	Dnsapi.dll

См. также

DnsWriteQuestionToBuffer

Поделиться через