SetInterfaceDnsSettings-Funktion (netioapi.h)
Legt die im Einstellungsparameter angegebenen DNS-Einstellungen pro Schnittstelle fest.
Syntax
NETIOAPI_API SetInterfaceDnsSettings(
GUID Interface,
const DNS_INTERFACE_SETTINGS *Settings
);
Parameter
Interface
Typ: _In_ GUID
Die GUID der COM-Schnittstelle, auf die sich die Einstellungen beziehen.
Settings
Typ: _In_ const DNS_INTERFACE_SETTINGS*
Ein Zeiger auf eine DNS_INTERFACE_SETTINGS-Struktur, die die DNS-Schnittstelleneinstellungen enthält.
Wenn dieser Parameter auf eine DNS_INTERFACE_SETTINGS-Struktur verweist, muss der DNS_INTERFACE_SETTINGS::Version-Member auf DNS_INTERFACE_SETTINGS_VERSION1 festgelegt werden.
Wenn dieser Parameter auf eine DNS_INTERFACE_SETTINGS_EX-Struktur verweist, muss die Version auf DNS_INTERFACE_SETTINGS_VERSION2 festgelegt werden.
Wenn dieser Parameter auf eine DNS_INTERFACE_SETTINGS3-Struktur verweist, muss die Version auf DNS_INTERFACE_SETTINGS_VERSION3 festgelegt werden.
Sie müssen alle gewünschten Optionen im Feld DNS_INTERFACE_SETTINGS::Flags entsprechend festlegen und nur die Felder auffüllen, für die eine Option festgelegt wurde. Sie müssen alle anderen Felder, die keine entsprechende Option haben, auf null stellen.
Rückgabewert
Gibt bei erfolgreicher Ausführung NO_ERROR zurück. Ein Rückgabewert ungleich NULL weist auf einen Fehler hin.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 Build 19041 |
| Unterstützte Mindestversion (Server) | Windows 10 Build 19041 |
| Zielplattform | Windows |
| Kopfzeile | netioapi.h (include Iphlpapi.h) |
| Bibliothek | Iphlpapi.lib |
| DLL | Iphlpapi.dll |