DNS_QUERY_RAW_COMPLETION_ROUTINE fonction de rappel (windns.h)

DNS_QUERY_RAW_COMPLETION_ROUTINE est la signature de fonction d’une fonction de rappel asynchrone que vous implémentez. Le système appelle votre implémentation avec les résultats d’une requête que vous avez lancée en appelant DnsQueryRaw. Les résultats contiennent à la fois les enregistrements analysés et le paquet de résultat brut, à transmettre aux systèmes ultérieurs comme vous le souhaitez. Le résultat fournit des informations sur le serveur qui a fourni les résultats.

Le système appelle ce rappel à l’achèvement de la requête si DnsQueryRaw retourne DNS_REQUEST_PENDING ; et indique les résultats de la requête en cas de réussite, ou d’échecs ou d’annulations.

Syntaxe

DNS_QUERY_RAW_COMPLETION_ROUTINE DnsQueryRawCompletionRoutine;

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

Paramètres

queryContext

Type : _In_ VOID*

Pointeur vers le contexte de requête passé à DnsQueryRaw via le champ queryContext de DNS_QUERY_RAW_REQUEST.

queryResults

Type : _Inout_ DNS_QUERY_RAW_RESULT*

Pointeur vers les résultats de la requête. Si ce rappel est effectué en raison d’une annulation de requête via DnsCancelQueryRaw, le champ queryStatus dans queryResults est défini sur ERROR_CANCELLED.

Si ce n’est pas NULL, vous devez libérer le pointeur queryResults à l’aide de DnsQueryRawResultFree.

Valeur de retour

None

Configuration requise