PSTART_PROTOCOL Rückruffunktion (routprot.h)

Die Funktion StartProtocol initialisiert die Funktionalität des Routingprotokolls. Der Router-Manager verwendet diese Funktion, um die globalen Konfigurationsparameter des Routingprotokolls und eine Reihe von API-Einstiegspunkten zu übergeben. Das Protokoll verwendet diese Einstiegspunkte, um den Router-Manager aufzurufen.

Syntax

PSTART_PROTOCOL PstartProtocol;

DWORD PstartProtocol(
  [in] HANDLE NotificationEvent,
  [in] PSUPPORT_FUNCTIONS SupportFunctions,
  [in] LPVOID GlobalInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Parameter

[in] NotificationEvent

Behandeln eines Ereignisobjekts. Das Routingprotokoll signalisiert dieses Ereignis, wenn der Router-Manager eine asynchrone Nachricht aus der vom Protokoll verwalteten Warteschlange abrufen soll.

[in] SupportFunctions

Zeiger auf eine SUPPORT_FUNCTIONS-Struktur . Die Felder dieser Struktur sind Zeiger auf Funktionen im Router-Manager. Diese Funktionen ermöglichen dem Protokoll den Zugriff auf Informationen, die Routingprotokolle umfassen.

[in] GlobalInfo

Zeiger auf protokolldefinierte globale Konfigurationsinformationen im Gegensatz zu schnittstellenspezifischen Konfigurationsinformationen. Diese Informationen sind für das Routingprotokoll privat.

[in] StructureVersion

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

[in] StructureSize

Gibt die Größe der einzelnen Informationsstrukturen an, auf die der GlobalInfo-Parameter verweist. 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 GlobalInfo-Parameter angezeigten Informationsstrukturen an. Dieser Parameter ist immer eins.

Rückgabewert

Wenn die Funktion erfolgreich ist und das Protokoll bereit ist, Schnittstelleninformationen zu empfangen, wird der Rückgabewert NO_ERROR.

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

Anforderungen

Weitere Informationen

GetEventMessage

Routingprotokollschnittstellenfunktionen

Referenz zur Routingprotokollschnittstelle

SUPPORT_FUNCTIONS

StopProtocol