DNS_INTERFACE_SETTINGS3 struttura (netioapi.h)
Rappresenta le impostazioni DNS che possono essere configurate in un'interfaccia specifica chiamando la funzione SetInterfaceDnsSettings o recuperata per una determinata interfaccia chiamando la funzione GetInterfaceDnsSettings .
Sintassi
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;
Members
Version
Tipo: ULONG
Deve essere impostato su DNS_INTERFACE_SETTINGS_VERSION3.
Flags
Tipo: ULONG64
Bitmap delle opzioni seguenti.
DNS_SETTING_IPV6 (0x0001 ). Configura le impostazioni dell'interfaccia solo per lo stack di rete IPv6. Se questa opzione è impostata, gli indirizzi IP specificati nei membri NameServer o ProfileNameServer devono essere indirizzi IPv6. Per impostazione predefinita, le impostazioni dell'interfaccia DNS specificate in questa struttura vengono applicate solo allo stack di rete IPv4.
DNS_SETTING_NAMESERVER (0x0002 ). Configura i server DNS della scheda statica nell'interfaccia specificata tramite il membro NameServer .
DNS_SETTING_SEARCHLIST (0x0004 ). Configura l'elenco di ricerca del suffisso DNS specifico della connessione per l'adapter specificato tramite il membro SearchList .
DNS_SETTING_REGISTRATION_ENABLED (0x0008 ). Abilita o disabilita la registrazione DNS dinamica per l'adattatore specificato. Questa opzione è abilitata per impostazione predefinita.
DNS_SETTING_DOMAIN (0x0020 ). Configura il suffisso DNS specifico della connessione per la scheda specificata tramite il membro Dominio .
DNS_SETTINGS_ENABLE_LLMNR (0x0080 ). Abilita o disabilita la risoluzione dei nomi usando LLMNR e mDNS nella scheda specificata. Questa opzione è abilitata per impostazione predefinita.
DNS_SETTINGS_QUERY_ADAPTER_NAME (0x0100 ). Abilita o disabilita l'uso del nome dell'adapter come suffisso per le query DNS. Questa opzione è abilitata per impostazione predefinita.
DNS_SETTING_PROFILE_NAMESERVER (0x0200 ). Configura i server DNS del profilo statico nell'interfaccia specificata tramite il membro ProfileNameServer .
DNS_SETTING_SUPPLEMENTAL_SEARCH_LIST (0x0800 ). Configura l'elenco di ricerca del suffisso aggiuntivo DNS specifico della connessione per l'adattatore specificato tramite il membro SupplementalSearchList .
DNS_SETTING_DOH (0x1000 ). Configura le impostazioni DNS-over-HTTPS nella scheda specificata tramite i membri cServerProperties e ServerProperties . Se questa opzione è impostata, il membro NameServer deve puntare a una stringa valida contenente una serie di server DNS separati da virgole o spazi.
DNS_SETTING_DOH_PROFILE (0x2000 ). Configura le impostazioni DNS-over-HTTPS del profilo nella scheda specificata tramite i membri cProfileServerProperties e ProfileServerProperties . Se questa opzione è impostata, il membro ProfileNameServer deve puntare a una stringa valida contenente una serie di server DNS separati da virgole o spazi.
Domain
Tipo: PWSTR
Stringa wide con terminazione NULL contenente il nome di dominio dell'adattatore.
NameServer
Tipo: PWSTR
Stringa wide con terminazione NULL contenente una serie di server DNS separati da virgole o spazi. Ad esempio, L"1.1.1.1 8.8.8.8", o L"1.1.1.1,8.8.8".
Se il flag DNS_SETTING_IPV6 è presente, i server devono essere indirizzi IPv6. Ad esempio, L"2606:4700:4700::1001,2606:4700::4700::1111".
SearchList
Tipo: PWSTR
Stringa wide con terminazione NULL contenente una serie di nomi di ricerca delimitati da virgole o spazi. Ad esempio, L"contoso1.com contoso2.com" o L"contoso1.com, contoso2.com".
RegistrationEnabled
Tipo: ULONG
TRUE per abilitare la registrazione dinamica dell'adattatore; FALSE per disabilitarlo.
RegisterAdapterName
Tipo: ULONG
TRUE per abilitare la registrazione dei nomi dell'adattatore; FALSE per disabilitarlo.
EnableLLMNR
Tipo: ULONG
TRUE per abilitare mDNS e LLMNR nell'interfaccia specificata; FALSE per disabilitarli.
QueryAdapterName
Tipo: ULONG
TRUE se il nome dell'adattatore deve essere usato come suffisso di ricerca; in caso contrario FALSE.
ProfileNameServer
Tipo: PWSTR
Stringa wide con terminazione NULL contenente una serie di server DNS separati da virgole o spazi. Ad esempio, L"1.1.1.1 8.8.8.8" o L"1.1.1.1,8.8.8".
Se il flag DNS_SETTING_IPV6 è presente, i server devono essere indirizzi IPv6. Ad esempio, L"2606:4700:4700::1001,2606:4700::4700::1111".
DisableUnconstrainedQueries
Tipo: ULONG
Riservato.
SupplementalSearchList
Tipo: PWSTR
Stringa wide con terminazione NULL contenente una serie di nomi di ricerca delimitati da virgole o spazi. Ad esempio, L"contoso1.com contoso2.com" o L"contoso1.com, contoso2.com".
cServerProperties
Tipo: ULONG
Numero di proprietà del server specificate nel membro ServerProperties . Se è uguale a 0, il membro "ServerProperties" deve essere NULL.
ServerProperties
Tipo: DNS_SERVER_PROPERTY*
Matrice di strutture DNS_SERVER_PROPERTY contenente elementi cServerProperties . Se cServerProperties è 0, deve essere NULL.
Sono supportate solo le proprietà DNS-over-HTTPS, con la restrizione aggiuntiva di almeno 1 proprietà per ogni server specificato nel membro NameServer .
Il membro DNS_SERVER_PROPERTY::Version deve essere impostato su DNS_SERVER_PROPERTY_VERSION1, ::Type deve essere impostato su DNS_SERVER_PROPERTY_TYPE::D nsServerDohProperty e property.DohSettings deve puntare a un oggetto DNS_DOH_SERVER_SETTINGS valido.
Il membro ServerIndex del DNS_SERVER_PROPERTY deve essere impostato sull'indice del server DNS corrispondente dal membro NameServer .
Ad esempio, se il membro NameServer è impostato su L"1.1.1.1, 8.8.8.8, 9.9.9.9.9", quindi una proprietà per il server 1.1.1.1 avrà il membro ServerIndex impostato su 0. Analogamente, 8.8.8.8 richiede serverIndex impostato su 1 e 9.9.9.9.9 richiede il membro ServerIndex impostato su 2.
cProfileServerProperties
Tipo: ULONG
Numero di proprietà del server specificate nel membro ProfileServerProperties . Se è uguale a 0, il membro ProfileServerProperties deve essere NULL.
ProfileServerProperties
Tipo: DNS_SERVER_PROPERTY*
Matrice di strutture DNS_SERVER_PROPERTY contenente elementi cProfileServerProperties . Se cProfileServerProperties è 0, deve essere NULL.
Sono supportate solo le proprietà DNS-over-HTTPS, con la restrizione aggiuntiva di almeno 1 proprietà per ogni server specificato nel membro ProfileNameServer .
Il membro DNS_SERVER_PROPERTY::Version deve essere impostato su DNS_SERVER_PROPERTY_VERSION1, ::Type deve essere impostato su DNS_SERVER_PROPERTY_TYPE::D nsServerDohProperty e Property.DohSettings deve puntare a un oggetto DNS_DOH_SERVER_SETTINGS valido.
Il membro ServerIndex del DNS_SERVER_PROPERTY deve essere impostato sull'indice del server DNS corrispondente dal membro ProfileNameServer .
Ad esempio, se il membro ProfileNameServer è impostato su L"1.1.1.1, 8.8.8.8,8, 9.9.9.9", quindi una proprietà per il server 1.1.1.1 avrà il membro ServerIndex impostato su 0. Analogamente, 8.8.8.8 richiede serverIndex impostato su 1 e 9.9.9.9.9 richiede il membro ServerIndex impostato su 2.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 Build 19645 |
| Server minimo supportato | Windows 10 Build 19645 |
| Intestazione | netioapi.h (includere Iphlpapi.h) |