struktur DNS_INTERFACE_SETTINGS3 (netioapi.h)
Mewakili pengaturan DNS yang dapat dikonfigurasi pada antarmuka tertentu dengan memanggil fungsi SetInterfaceDnsSettings atau diambil untuk antarmuka tertentu dengan memanggil fungsi GetInterfaceDnsSettings .
Sintaks
typedef struct _DNS_INTERFACE_SETTINGS3 {
ULONG Version;
ULONG64 Flags;
PWSTR Domain;
PWSTR NameServer;
PWSTR SearchList;
ULONG RegistrationEnabled;
ULONG RegisterAdapterName;
ULONG EnableLLMNR;
ULONG QueryAdapterName;
PWSTR ProfileNameServer;
ULONG DisableUnconstrainedQueries;
PWSTR SupplementalSearchList;
ULONG cServerProperties;
DNS_SERVER_PROPERTY *ServerProperties;
ULONG cProfileServerProperties;
DNS_SERVER_PROPERTY *ProfileServerProperties;
} DNS_INTERFACE_SETTINGS3;
Anggota
Version
Jenis: ULONG
Harus diatur ke DNS_INTERFACE_SETTINGS_VERSION3.
Flags
Jenis: ULONG64
Bitmap dari opsi berikut.
DNS_SETTING_IPV6 (0x0001). Mengonfigurasi pengaturan antarmuka hanya untuk tumpukan jaringan IPv6. Jika opsi ini diatur, maka alamat IP apa pun yang ditentukan dalam anggota NameServer atau ProfileNameServer harus alamat IPv6. Secara default, pengaturan antarmuka DNS yang ditentukan dalam struktur ini hanya diterapkan ke tumpukan jaringan IPv4.
DNS_SETTING_NAMESERVER (0x0002). Mengonfigurasi server DNS adapter statis pada antarmuka yang ditentukan melalui anggota NameServer .
DNS_SETTING_SEARCHLIST (0x0004). Mengonfigurasi daftar pencarian akhiran DNS khusus koneksi untuk adaptor yang diberikan melalui anggota SearchList .
DNS_SETTING_REGISTRATION_ENABLED (0x0008). Mengaktifkan atau menonaktifkan pendaftaran DNS dinamis untuk adaptor yang diberikan. Ini diaktifkan sistem secara default.
DNS_SETTING_DOMAIN (0x0020). Mengonfigurasi akhiran DNS khusus koneksi untuk adaptor yang diberikan melalui anggota Domain .
DNS_SETTINGS_ENABLE_LLMNR (0x0080). Mengaktifkan atau menonaktifkan resolusi nama menggunakan LLMNR dan mDNS pada adaptor yang ditentukan. Ini diaktifkan sistem secara default.
DNS_SETTINGS_QUERY_ADAPTER_NAME (0x0100). Mengaktifkan atau menonaktifkan penggunaan nama adaptor sebagai akhiran untuk kueri DNS. Ini diaktifkan sistem secara default.
DNS_SETTING_PROFILE_NAMESERVER (0x0200). Mengonfigurasi server DNS profil statis pada antarmuka yang ditentukan melalui anggota ProfileNameServer .
DNS_SETTING_SUPPLEMENTAL_SEARCH_LIST (0x0800). Mengonfigurasi daftar pencarian akhiran tambahan DNS khusus koneksi untuk adaptor yang diberikan melalui anggota SupplementalSearchList .
DNS_SETTING_DOH (0x1000). Mengonfigurasi pengaturan DNS-over-HTTPS pada adaptor yang ditentukan melalui anggota cServerProperties dan ServerProperties . Jika opsi ini diatur, maka anggota NameServer harus menunjuk ke string yang valid yang berisi serangkaian server DNS yang dipisahkan spasi atau koma.
DNS_SETTING_DOH_PROFILE (0x2000). Mengonfigurasi pengaturan DNS-over-HTTPS profil pada adaptor yang ditentukan melalui anggota cProfileServerProperties dan ProfileServerProperties . Jika opsi ini diatur, maka anggota ProfileNameServer harus menunjuk ke string yang valid yang berisi serangkaian server DNS yang dipisahkan spasi atau koma.
Domain
Jenis: PWSTR
String lebar yang dihentikan NULL yang berisi nama domain adaptor.
NameServer
Jenis: PWSTR
String lebar yang dihentikan NULL yang berisi serangkaian server DNS yang dipisahkan koma atau spasi. Misalnya, L"1.1.1.1 8.8.8.8", atau L"1.1.1.1,8.8.8.8".
Jika bendera DNS_SETTING_IPV6 ada, maka server harus alamat IPv6. Misalnya, L"2606:4700:4700::1001,2606:4700:4700::1111".
SearchList
Jenis: PWSTR
String lebar yang dihentikan NULL yang berisi serangkaian nama pencarian yang dipisahkan koma atau spasi. Misalnya, L"contoso1.com contoso2.com", atau L"contoso1.com, contoso2.com".
RegistrationEnabled
Jenis: ULONG
TRUE untuk mengaktifkan pendaftaran dinamis adaptor; FALSE untuk menonaktifkannya.
RegisterAdapterName
Jenis: ULONG
TRUE untuk mengaktifkan pendaftaran nama adapter; FALSE untuk menonaktifkannya.
EnableLLMNR
Jenis: ULONG
TRUE untuk mengaktifkan mDNS dan LLMNR pada antarmuka yang diberikan; FALSE untuk menonaktifkannya.
QueryAdapterName
Jenis: ULONG
TRUE jika nama adaptor harus digunakan sebagai akhiran pencarian; jika tidak FALSE.
ProfileNameServer
Jenis: PWSTR
String lebar yang dihentikan NULL yang berisi serangkaian server DNS yang dipisahkan koma atau spasi. Misalnya, L"1.1.1.1 8.8.8.8" atau L"1.1.1.1,8.8.8.8".
Jika bendera DNS_SETTING_IPV6 ada, maka server harus alamat IPv6. Misalnya, L"2606:4700:4700::1001,2606:4700:4700::1111".
DisableUnconstrainedQueries
Jenis: ULONG
Dicadangkan.
SupplementalSearchList
Jenis: PWSTR
String lebar yang dihentikan NULL yang berisi serangkaian nama pencarian yang dipisahkan koma atau spasi. Misalnya, L"contoso1.com contoso2.com", atau L"contoso1.com, contoso2.com".
cServerProperties
Jenis: ULONG
Jumlah properti server yang ditentukan dalam anggota ServerProperties . Jika ini sama dengan 0, maka anggota "ServerProperties" harus NULL.
ServerProperties
Jenis: DNS_SERVER_PROPERTY*
Array struktur DNS_SERVER_PROPERTY , yang berisi elemen cServerProperties . Jika cServerProperties adalah 0, maka ini harus NULL.
Hanya properti DNS-over-HTTPS yang didukung, dengan pembatasan tambahan paling banyak 1 properti untuk setiap server yang ditentukan dalam anggota NameServer .
Anggota DNS_SERVER_PROPERTY::Version harus diatur ke DNS_SERVER_PROPERTY_VERSION1, ::Type harus diatur ke DNS_SERVER_PROPERTY_TYPE::D nsServerDohProperty, dan Property.DohSettings harus menunjuk ke objek DNS_DOH_SERVER_SETTINGS yang valid.
Anggota ServerIndexdari DNS_SERVER_PROPERTY harus diatur ke indeks server DNS terkait dari anggota NameServer .
Misalnya, jika anggota NameServer diatur ke L"1.1.1.1, 8.8.8.8, 9.9.9.9", maka properti untuk server 1.1.1.1 akan memiliki anggota ServerIndex yang diatur ke 0. Demikian pula, 8.8.8.8 akan memerlukan ServerIndex diatur ke 1, dan 9.9.9.9 akan mengharuskan anggota ServerIndex diatur ke 2.
cProfileServerProperties
Jenis: ULONG
Jumlah properti server yang ditentukan dalam anggota ProfileServerProperties . Jika ini sama dengan 0, maka anggota ProfileServerProperties harus NULL.
ProfileServerProperties
Jenis: DNS_SERVER_PROPERTY*
Array struktur DNS_SERVER_PROPERTY , yang berisi elemen cProfileServerProperties . Jika cProfileServerProperties adalah 0, maka ini harus NULL.
Hanya properti DNS-over-HTTPS yang didukung, dengan pembatasan tambahan paling banyak 1 properti untuk setiap server yang ditentukan dalam anggota ProfileNameServer .
Anggota DNS_SERVER_PROPERTY::Version harus diatur ke DNS_SERVER_PROPERTY_VERSION1, ::Type harus diatur ke DNS_SERVER_PROPERTY_TYPE::D nsServerDohProperty dan Property.DohSettings harus menunjuk ke objek DNS_DOH_SERVER_SETTINGS yang valid.
Anggota ServerIndexdari DNS_SERVER_PROPERTY harus diatur ke indeks server DNS terkait dari anggota ProfileNameServer .
Misalnya, jika anggota ProfileNameServer diatur ke L"1.1.1.1, 8.8.8.8, 9.9.9.9", maka properti untuk server 1.1.1.1 akan memiliki anggota ServerIndex yang diatur ke 0. Demikian pula, 8.8.8.8 akan memerlukan ServerIndex diatur ke 1, dan 9.9.9.9 akan mengharuskan anggota ServerIndex diatur ke 2.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 10 Build 19645 |
| Server minimum yang didukung | Windows 10 Build 19645 |
| Header | netioapi.h (termasuk Iphlpapi.h) |