다음을 통해 공유


DnsCancelQuery 함수(windns.h)

DnsCancelQuery 함수를 사용하여 DNS 네임스페이스에 대한 보류 중인 쿼리를 취소할 수 있습니다.

구문

DNS_STATUS DnsCancelQuery(
  [in] PDNS_QUERY_CANCEL pCancelHandle
);

매개 변수

[in] pCancelHandle

비동기 DNS 쿼리를 취소하는 데 사용되는 DNS_QUERY_CANCEL 구조체에 대한 포인터입니다. 구조체는 DnsQueryEx에 대한 이전 호출의 pCancelHandle 매개 변수에서 반환되어야 합니다.

반환 값

성공적으로 완료되면 성공 확인을 반환합니다. 그렇지 않으면 Winerror.h에 정의된 적절한 DNS 관련 오류 코드를 반환합니다.

설명

DnsCancelQuery 는 취소하기 전에 쿼리가 완료되기를 기다리지 않습니다. 따라서 애플리케이션은 DNS_QUERY_COMPLETION_ROUTINE DNS 콜백을 통해 보류 중인 쿼리를 추적해야 합니다.

pCancelHandleDNS_QUERY_COMPLETION_ROUTINE DNS 콜백이 호출되고 DnsCancelQuery 가 완료될 때까지 유효합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 windns.h
라이브러리 Dnsapi.lib
DLL Dnsapi.dll

추가 정보

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST

DNS_QUERY_RESULT

DnsQuery

DnsQueryEx