PADD_INTERFACE Rückruffunktion (routprot.h)
Die AddInterface-Funktion fügt eine Schnittstelle hinzu, die vom Routingprotokoll verwaltet werden soll. Das Protokoll sollte berücksichtigen, dass sich die Schnittstelle in einem deaktivierten Zustand befindet. Der Router-Manager aktiviert die Schnittstelle, indem InterfaceStatus mit dem flag RIS_INTERFACE_ENABLED aufgerufen wird.
Wenn ein Benutzer MprAdminInterfaceTransportAdd aufruft, ruft der dynamische Schnittstellen-Manager für den Transport den Router-Manager (für den Transport) auf, der diese Funktion für jedes routingprotokoll aufruft, das diesem Transport zugeordnet ist.
Syntax
PADD_INTERFACE PaddInterface;
DWORD PaddInterface(
[in] LPWSTR InterfaceName,
[in] ULONG InterfaceIndex,
[in] NET_INTERFACE_TYPE InterfaceType,
[in] DWORD MediaType,
[in] WORD AccessType,
[in] WORD ConnectionType,
[in] PVOID InterfaceInfo,
[in] ULONG StructureVersion,
[in] ULONG StructureSize,
[in] ULONG StructureCount
)
{...}
Parameter
[in] InterfaceName
Zeiger auf eine Unicode-Zeichenfolge. Die Zeichenfolge enthält einen Namen, der die Schnittstelle in der Gruppe von Schnittstellen identifiziert, die auf dem Router konfiguriert sind.
[in] InterfaceIndex
Gibt die Schnittstelle in der Gruppe von Schnittstellen an, die auf dem Router konfiguriert sind.
[in] InterfaceType
Gibt den Typ der Schnittstelle an.
[in] MediaType
Für zukünftige Verwendung reserviert.
[in] AccessType
Für zukünftige Verwendung reserviert.
[in] ConnectionType
Für zukünftige Verwendung reserviert.
[in] InterfaceInfo
Zeiger auf einen Puffer, der protokolldefinierte Konfigurationsinformationen angibt, die der Schnittstelle zugeordnet sind. Diese Informationen sind für das Routingprotokoll privat.
[in] StructureVersion
Gibt die Version der Informationsstrukturen an, auf die vom Parameter InterfaceInfo verwiesen wird. In einigen Fällen entspricht dies der Version des Routingprotokolls.
[in] StructureSize
Gibt die Größe der einzelnen Informationsstrukturen an, auf die vom Parameter InterfaceInfo verwiesen wird. Da einige Informationsstrukturen Elemente mit variabler Länge enthalten, kann das Routingprotokoll nicht unbedingt die Größe der Informationen aus der Version bestimmen.
[in] StructureCount
Gibt eine Anzahl der Vom InterfaceInfo-Parameter angezeigten Informationsstrukturen an. 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 |
|---|---|
|
Fehler beim Hinzufügen der Schnittstelle. |
|
Der Parameter InterfaceIndex ist ungültig (z. B. ist bereits eine Schnittstelle mit diesem Index vorhanden), oder einer der Parameter, auf die von InterfaceInfo verwiesen wird, ist 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 |