DNS_QUERY_REQUEST 구조체(windns.h)

DNS_QUERY_REQUEST 구조에는 DnsQueryEx 호출에 사용되는 DNS 쿼리 매개 변수가 포함됩니다.

구문

typedef struct _DNS_QUERY_REQUEST {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
} DNS_QUERY_REQUEST, *PDNS_QUERY_REQUEST;

멤버

Version

구조체 버전은 다음 중 하나여야 합니다.

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

쿼리할 DNS 이름을 나타내는 문자열에 대한 포인터입니다.

참고QueryName 이 NULL인 경우 쿼리는 로컬 컴퓨터 이름에 대한 것입니다.

 

QueryType

쿼리되는 RR(리소스 레코드) DNS 레코드 형식 을 나타내는 값입니다. QueryType은 DNS_QUERY_RESULT 구조에서 반환된 pQueryRecords가 가리키는 데이터의 형식을 결정합니다. 예를 들어 wType 값이 DNS_TYPE_A 경우 pQueryRecords 가 가리키는 데이터 형식은 DNS_A_DATA.

QueryOptions

DNS 쿼리에 사용할 DNS 쿼리 옵션의 비트맵을 포함하는 값입니다. 옵션을 결합하고 모든 옵션을 재정의 할 수 DNS_QUERY_STANDARD

pDnsServerList

쿼리에 사용할 DNS 서버 목록이 포함된 DNS_ADDR_ARRAY 구조체에 대한 포인터입니다.

InterfaceIndex

쿼리가 전송되는 인터페이스 인덱스를 포함하는 값입니다. InterfaceIndex가 0이면 모든 인터페이스가 고려됩니다.

pQueryCompletionCallback

DnsQueryEx 호출에서 비동기 쿼리의 결과를 반환하는 데 사용되는 DNS_QUERY_COMPLETION_ROUTINE 콜백에 대한 포인터입니다.

참고 NULL이면 DnsQueryEx 가 동기적으로 호출됩니다.

 

pQueryContext

사용자 컨텍스트에 대한 포인터입니다.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
머리글	windns.h

추가 정보

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_RESULT

DnsCancelQuery

DnsQuery

DnsQueryEx