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

Weitere Informationen

• GetInterfaceDnsSettings