Fungsi DnsQueryConfig (windns.h)

Artikel
03/15/2023

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

Sintaks

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 Bebaskan memori yang dialokasikan dengan LocalFree.

[in, optional] pwsAdapterName

Penunjuk ke string yang mewakili nama adaptor tempat kueri dijalankan.

[in, optional] pReserved

Disiapkan untuk penggunaan 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.

Nilai kembali

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

Persyaratan


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_CONFIG_TYPE

DNS_RECORD

DnsQuery

Bagikan melalui