Bagikan melalui

struktur DNS_QUERY_REQUEST3 (windns.h)

  • Artikel

Berisi parameter kueri DNS yang digunakan dalam panggilan ke DnsQueryEx.

Sintaks

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;

Anggota

Version

Jenis: ULONG

Versi struktur harus DNS_QUERY_REQUEST_VERSION3; yang memiliki nilai 3.

QueryName

Jenis: PCWSTR

Penunjuk ke string yang mewakili nama DNS untuk dikueri.

Catatan

Jika QueryName adalah NULL, maka kuerinya adalah untuk nama komputer lokal.

QueryType

Jenis: WORD

Nilai yang mewakili Tipe Catatan DNS Rekaman Sumber Daya (RR) yang dikueri. QueryType menentukan format data yang ditunjukkan oleh pQueryRecords yang dikembalikan dalam struktur DNS_QUERY_RESULT . Misalnya, jika nilai wTypeDNS_TYPE_A, format data yang ditujukan oleh pQueryRecordsDNS_A_DATA.

QueryOptions

Jenis: ULONG64

Nilai yang berisi bitmap Opsi Kueri DNS untuk digunakan dalam kueri DNS. Opsi dapat digabungkan, dan semua opsi mengambil alih DNS_QUERY_STANDARD.

pDnsServerList

Jenis: PDNS_ADDR_ARRAY

Penunjuk ke struktur DNS_ADDR_ARRAY yang berisi daftar server DNS untuk digunakan dalam kueri.

InterfaceIndex

Jenis: ULONG

Nilai yang berisi indeks antarmuka tempat kueri dikirim. Jika InterfaceIndex adalah 0, maka semua antarmuka akan dipertimbangkan.

pQueryCompletionCallback

Jenis: PDNS_QUERY_COMPLETION_ROUTINE

Penunjuk ke panggilan balik DNS_QUERY_COMPLETION_ROUTINE yang digunakan untuk mengembalikan hasil kueri asinkron dari panggilan ke DnsQueryEx.

Catatan

Jika NULL, maka DnsQueryEx dipanggil secara sinkron.

pQueryContext

Jenis: PVOID

Penunjuk ke konteks pengguna.

IsNetworkQueryRequired

Jenis: BOOL

Dicadangkan.

RequiredNetworkIndex

Jenis: DWORD

Dicadangkan.

cCustomServers

Jenis: DWORD

Jumlah server kustom yang diacu oleh anggota pCustomServers .

pCustomServers

Jenis: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

Penunjuk ke array N (di mana N diberikan di bidang cCustomServers ) DNS_CUSTOM_SERVER objek.

Jika cCustomServers adalah 0, maka pCustomServers harus NULL.

Catatan

Setidaknya salah satu pCustomServers dan pDnsServerList harus NULL. Keduanya diatur ke nilai non-NULL pada saat yang sama tidak didukung.

Keterangan

Server kustom yang ditentukan dalam pCustomServers melewati server DNS yang dikonfigurasi sistem.

Jika nama kueri cocok dengan aturan dalam Tabel Kebijakan Resolusi Nama (NRPT), maka server kustom diabaikan, dan hanya server dari aturan NRPT yang digunakan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Build 22000
Server minimum yang didukung Windows Build 22000
Header windns.h

Lihat juga