Share via

GetInterfaceDnsSettings-Funktion (netioapi.h)

  • Artikel

Ruft die DNS-Einstellungen von der im Parameter Interface angegebenen Schnittstelle ab. Wenn Sie mit dem zurückgegebenen Einstellungsobjekt fertig sind, müssen Sie FreeInterfaceDnsSettings aufrufen, um es freizugeben.

Syntax

NETIOAPI_API GetInterfaceDnsSettings(
  GUID                   Interface,
  DNS_INTERFACE_SETTINGS *Settings
);

Parameter

Interface

Typ: _In_ GUID

Die GUID der COM-Schnittstelle, auf die sich die Einstellungen beziehen.

Settings

Typ: _Inout_ const DNS_INTERFACE_SETTINGS*

GetInterfaceDnsSettings füllt alle Einstellungen in dieser Struktur auf.

Sie sollten nur das Element Version festlegen. Das Feld Flags muss leer sein.

Wenn Sie das Element Version auf DNS_INTERFACE_SETTINGS_VERSION1 festlegen, muss der Einstellungsparameter auf eine gültige DNS_INTERFACE_SETTINGS-Struktur verweisen.

Wenn Sie das Element Version auf DNS_INTERFACE_SETTINGS_VERSION2 festlegen, muss der Einstellungsparameter auf eine gültige DNS_INTERFACE_SETTINGS_EX-Struktur verweisen.

Wenn Sie das Element Version auf DNS_INTERFACE_SETTINGS_VERSION3 festlegen, muss der Einstellungsparameter auf eine gültige DNS_INTERFACE_SETTINGS3-Struktur verweisen.

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

Weitere Informationen