функция обратного вызова DNS_QUERY_RAW_COMPLETION_ROUTINE (windns.h)

Статья
09/21/2023

Важно!

Некоторые сведения относятся к предварительной версии продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

DNS_QUERY_RAW_COMPLETION_ROUTINE — это сигнатура функции асинхронного обратного вызова, которую вы реализуете. Система вызывает реализацию с результатами запроса, инициированного путем вызова DnsQueryRaw. Результаты содержат как проанализированные записи, так и необработанный пакет результатов, которые будут по желанию переданы в более поздние системы. Результат предоставляет сведения о сервере, который предоставил результаты.

Система вызывает этот обратный вызов после завершения запроса, если DnsQueryRaw возвращает DNS_REQUEST_PENDING; и будет указывать результаты запроса в случае успешного выполнения, а также любые сбои или отмены.

Синтаксис

DNS_QUERY_RAW_COMPLETION_ROUTINE DnsQueryRawCompletionRoutine;

void DnsQueryRawCompletionRoutine(
  VOID *queryContext,
  DNS_QUERY_RAW_RESULT *queryResults
)
{...}

Параметры

queryContext

Тип: _In_ VOID*

Указатель на контекст запроса, переданный в DnsQueryRaw через поле queryContextDNS_QUERY_RAW_REQUEST.

queryResults

Тип: _Inout_ DNS_QUERY_RAW_RESULT*

Указатель на результаты запроса. Если этот обратный вызов выполняется из-за отмены запроса через DnsCancelQueryRaw, то для поля queryStatus в queryResults будет задано значение ERROR_CANCELLED.

Если это не NULLтак, необходимо освободить указатель queryResults с помощью DnsQueryRawResultFree.

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

None

Требования

Требование	Значение
Целевая платформа	Windows
Header	windns.h

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