다음을 통해 공유

DNS_QUERY_REQUEST3 구조체(windns.h)

  • 아티클

DnsQueryEx 호출에 사용되는 DNS 쿼리 매개 변수를 포함합니다.

구문

typedef struct _DNS_QUERY_REQUEST3 {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
  BOOL                          IsNetworkQueryRequired;
  DWORD                         RequiredNetworkIndex;
  DWORD                         cCustomServers;
  DNS_CUSTOM_SERVER             *pCustomServers;
} DNS_QUERY_REQUEST3, *PDNS_QUERY_REQUEST3;

멤버

Version

형식: ULONG

구조체 버전은 DNS_QUERY_REQUEST_VERSION3; 값이 3인 경우

QueryName

형식: PCWSTR

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

참고

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

QueryType

형식: WORD

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

QueryOptions

형식: ULONG64

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

pDnsServerList

형식: PDNS_ADDR_ARRAY

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

InterfaceIndex

형식: ULONG

쿼리가 전송되는 인터페이스 인덱스가 들어 있는 값입니다. InterfaceIndex가 0이면 모든 인터페이스가 고려됩니다.

pQueryCompletionCallback

형식: PDNS_QUERY_COMPLETION_ROUTINE

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

참고

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

pQueryContext

형식: PVOID

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

IsNetworkQueryRequired

형식: BOOL

예약되어 있습니다.

RequiredNetworkIndex

형식: DWORD

예약되어 있습니다.

cCustomServers

형식: DWORD

pCustomServers 멤버가 가리키는 사용자 지정 서버 수입니다.

pCustomServers

형식: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

개체를 DNS_CUSTOM_SERVER N 배열( cCustomServers 필드에 N이 지정 됨)에 대한 포인터입니다.

cCustomServers가 0이면 pCustomServers는 NULL이어야 합니다.

참고

pCustomServers 및 pDnsServerList 중 하나 이상이 NULL이어야 합니다. 둘 다 NULL 이 아닌 값으로 동시에 설정된 것은 지원되지 않습니다.

설명

pCustomServers에 지정된 사용자 지정 서버는 시스템 구성 DNS 서버를 무시합니다.

쿼리 이름이 NRPT(이름 확인 정책 테이블)의 규칙과 일치하는 경우 사용자 지정 서버는 무시되고 NRPT 규칙의 서버만 사용됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 빌드 22000
지원되는 최소 서버 Windows 빌드 22000
머리글 windns.h

추가 정보