fungsi DnsQuery_W (windns.h)

Artikel
03/13/2024

Jenis fungsi DnsQuery adalah antarmuka kueri generik ke namespace DNS, dan menyediakan antarmuka resolusi kueri DNS kepada pengembang aplikasi. Seperti banyak fungsi DNS, jenis fungsi DnsQuery diimplementasikan dalam beberapa formulir untuk memfasilitasi pengodean karakter yang berbeda. Berdasarkan pengodean karakter yang terlibat, gunakan salah satu fungsi berikut:

DnsQuery_A (untuk pengodean ANSI)
DnsQuery_W (untuk pengodean Unicode)
DnsQuery_UTF8 (untuk pengodean UTF-8)

Windows 8: Fungsi DnsQueryEx harus digunakan jika aplikasi memerlukan kueri asinkron ke namespace DNS.

Sintaks

DNS_STATUS DnsQuery_W(
  [in]                PCWSTR      pszName,
  [in]                WORD        wType,
  [in]                DWORD       Options,
  [in, out, optional] PVOID       pExtra,
  [out, optional]     PDNS_RECORD *ppQueryResults,
  [out, optional]     PVOID       *pReserved
);

Parameter

[in] pszName

Penunjuk ke string yang mewakili nama DNS yang akan dikueri.

[in] wType

Nilai yang mewakili Tipe Catatan DNS Resource Record (RR) yang dikueri. wType menentukan format data yang ditujukkan oleh ppQueryResultsSet. Misalnya, jika nilai wTypeDNS_TYPE_A, format data yang ditujukkan oleh ppQueryResultsSetDNS_A_DATA.

[in] Options

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

[in, out, optional] pExtra

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

[out, optional] ppQueryResults

Pilihan. Penunjuk ke penunjuk yang menunjuk ke daftar RR yang terdiri dari respons. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[out, optional] pReserved

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

Nilai kembali

Mengembalikan konfirmasi keberhasilan setelah berhasil diselesaikan. Jika tidak, mengembalikan kode kesalahan khusus DNS yang sesuai seperti yang didefinisikan dalam Winerror.h.

Keterangan

Aplikasi yang memanggil fungsi DnsQuery membuat kueri menggunakan nama DNS dan jenis Resource Record (RR) yang sepenuhnya memenuhi syarat, dan mengatur opsi kueri tergantung pada jenis layanan yang diinginkan. Saat opsi DNS_QUERY_STANDARD diatur, DNS menggunakan cache resolver, kueri terlebih dahulu dengan UDP, lalu mencoba kembali dengan TCP jika respons terpotong, dan meminta server untuk melakukan resolusi rekursif atas nama klien untuk menyelesaikan kueri.

Aplikasi harus bebas mengembalikan rangkaian RR dengan fungsi DnsRecordListFree .

Catatan Saat memanggil salah satu jenis fungsi DnsQuery , ketahuilah bahwa server DNS dapat mengembalikan beberapa rekaman sebagai respons terhadap kueri. Komputer yang multihomed, misalnya, akan menerima beberapa rekaman A untuk alamat IP yang sama. Pemanggil harus menggunakan sebanyak mungkin rekaman yang dikembalikan seperlunya.

Pertimbangkan skenario berikut, di mana beberapa rekaman yang dikembalikan memerlukan aktivitas tambahan atas nama aplikasi: Panggilan fungsi DnsQuery_A dilakukan untuk komputer multihomed dan aplikasi menemukan bahwa alamat yang terkait dengan rekaman A pertama tidak merespons. Aplikasi kemudian harus mencoba menggunakan alamat IP lain yang ditentukan dalam (tambahan) Catatan A yang dikembalikan dari panggilan fungsi DnsQuery_A .

Jika parameter lpstrName diatur ke NULL, fungsi DnsQuery gagal dengan kesalahan INVALID_PARAMETER.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	windns.h
Pustaka	Dnsapi.lib
DLL	Dnsapi.dll

Lihat juga

DNS_RECORD

DnsQueryEx

DnsRecordListFree

Bagikan melalui