다음을 통해 공유

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

쿼리되는 DNS 레코드 형식 RR(리소스 레코드)을 나타내는 값입니다. QueryTypeDNS_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*

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

cCustomServers 0이면 pCustomServers NULL합니다.

메모

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

발언

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

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

요구 사항

요구 값
지원되는 최소 클라이언트 Windows 빌드 22000
지원되는 최소 서버 Windows 빌드 22000
헤더 windns.h

참고 항목