DnsCancelQueryRaw function (windns.h)

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Cancels a query that was initiated by calling DnsQueryRaw.

If the query completion callback (see DNS_QUERY_RAW_COMPLETION_ROUTINE) hasn't been called by the time DnsCancelQueryRaw returns, then the query completion callback will lead to the callback being made with a queryStatus of ERROR_CANCELLED in the queryResults parameter.

Syntax

DNS_STATUS DnsCancelQueryRaw(
  DNS_QUERY_RAW_CANCEL *cancelHandle
);

Parameters

cancelHandle

Type: _In_ DNS_QUERY_RAW_CANCEL*

The cancel handle that you obtained by calling DnsQueryRaw.

Return value

A DNS_STATUS value indicating success or failure.

Requirements

Requirement	Value
Target Platform	Windows
Header	windns.h
Library	dnsapi.lib
DLL	dnsapi.dll