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 콜백을 통해 보류 중인 쿼리를 추적해야 합니다.
pCancelHandle 은 DNS_QUERY_COMPLETION_ROUTINE DNS 콜백이 호출되고 DnsCancelQuery 가 완료될 때까지 유효합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | windns.h |
| 라이브러리 | Dnsapi.lib |
| DLL | Dnsapi.dll |