Fungsi DnsQueryConfig (windns.h)

Artikel
01/16/2025

Fungsi DnsQueryConfig memungkinkan pemrogram aplikasi untuk mengkueri konfigurasi komputer lokal atau adaptor tertentu.

Sintaksis

DNS_STATUS DnsQueryConfig(
  [in]           DNS_CONFIG_TYPE Config,
  [in]           DWORD           Flag,
  [in, optional] PCWSTR          pwsAdapterName,
  [in, optional] PVOID           pReserved,
  [out]          PVOID           pBuffer,
  [in, out]      PDWORD          pBufLen
);

Parameter

[in] Config

Nilai DNS_CONFIG_TYPE yang menentukan jenis konfigurasi informasi yang akan dikueri.

[in] Flag

Nilai yang menentukan apakah akan mengalokasikan memori untuk informasi konfigurasi. Atur Bendera ke DNS_CONFIG_FLAG_ALLOC untuk mengalokasikan memori; jika tidak, atur ke 0.

Catatan Gratiskan memori yang dialokasikan dengan LocalFree.

[in, optional] pwsAdapterName

Penunjuk ke string yang mewakili nama adaptor tempat kueri dijalankan.

[in, optional] pReserved

Dicadangkan untuk digunakan di masa mendatang.

[out] pBuffer

Penunjuk ke buffer yang menerima respons kueri. Tabel berikut ini memperlihatkan jenis data buffer untuk setiap nilai parameter Konfigurasi .

parameter Konfigurasi	Jenis data buffer
DnsConfigPrimaryDomainName_W	PWCHAR
DnsConfigPrimaryDomainName_A	PCHAR
DnsConfigPrimaryDomainName_UTF8	PCHAR
DnsConfigAdapterDomainName_W	Tidak diimplementasikan
DnsConfigAdapterDomainName_A	Tidak diimplementasikan
DnsConfigAdapterDomainName_UTF8	Tidak diimplementasikan
DnsConfigDnsServerList	IP4_ARRAY
DnsConfigSearchList	Tidak diimplementasikan
DnsConfigAdapterInfo	Tidak diimplementasikan
DnsConfigPrimaryHostNameRegistrationEnabled	DWORD
DnsConfigAdapterHostNameRegistrationEnabled	DWORD
DnsConfigAddressRegistrationMaxCount	DWORD
DnsConfigHostName_W	PWCHAR
DnsConfigHostName_A	PCHAR
DnsConfigHostName_UTF8	PCHAR
DnsConfigFullHostName_W	PWCHAR
DnsConfigFullHostName_A	PCHAR
DnsConfigFullHostName_UTF8	PCHAR

[in, out] pBufLen

Panjang buffer, dalam byte. Jika buffer yang disediakan tidak cukup, kesalahan dikembalikan dan pBufferLength berisi ukuran buffer minimum yang diperlukan. Diabaikan pada input jika Bendera diatur ke TRUE.

Mengembalikan nilai

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

Persyaratan

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

Lihat juga

DNS_CONFIG_TYPE

DNS_RECORD

DnsQuery

Bagikan melalui