PSET_INTERFACE_INFO Rückruffunktion (routprot.h)

Artikel
03/01/2024

Die SetInterfaceInfo-Funktion legt die Konfiguration einer bestimmten Schnittstelle fest, die vom Routingprotokoll verwaltet wird.

Syntax

PSET_INTERFACE_INFO PsetInterfaceInfo;

DWORD PsetInterfaceInfo(
  [in] ULONG InterfaceIndex,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Parameter

[in] InterfaceIndex

Gibt die Schnittstelle in der Gruppe von Schnittstellen an, die auf dem Router konfiguriert sind.

[in] InterfaceInfo

Zeiger auf einen Puffer, der die protokolldefinierten Konfigurationsinformationen enthält, die der Schnittstelle zugeordnet sind. Diese Informationen sind für das Routingprotokoll privat.

[in] StructureVersion

Gibt die Version der Informationsstrukturen an, auf die der Parameter InterfaceInfo verweist. In einigen Fällen entspricht dies der Version des Routingprotokolls.

[in] StructureSize

Gibt die Größe der einzelnen Informationsstrukturen an, auf die der Parameter InterfaceInfo verweist. Da einige Informationsstrukturen Elemente mit variabler Länge enthalten, ist das Routingprotokoll nicht unbedingt in der Lage, die Größe der Informationen aus der Version zu bestimmen.

[in] StructureCount

Gibt die Anzahl der Informationsstrukturen an, auf die der Parameter InterfaceInfo verweist. Dieser Parameter ist immer eins.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	BESCHREIBUNG
ERROR_CAN_NOT_COMPLETE	Fehler beim Festlegen der Schnittstellenkonfiguration.
ERROR_INVALID_PARAMETER	Der Parameter InterfaceIndex ist ungültig (z. B. ist keine Schnittstelle mit diesem Index vorhanden), der Parameter InterfaceInfo ist NULL oder einer der Parameter in den Konfigurationsinformationen ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	routprot.h

Weitere Informationen

GetInterfaceInfo

Routingprotokollschnittstellenfunktionen

Referenz zur Routingprotokollschnittstelle

Freigeben über