PSTART_PROTOCOL funzione di callback (routprot.h)

La funzione StartProtocol inizializza la funzionalità del protocollo di routing. La gestione router usa questa funzione per passare i parametri di configurazione globale del protocollo di routing e un set di punti di ingresso api. Il protocollo usa questi punti di ingresso per chiamare nella gestione router.

Sintassi

PSTART_PROTOCOL PstartProtocol;

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

Parametri

[in] NotificationEvent

Handle in un oggetto evento. Il protocollo di routing segnala questo evento quando vuole che la gestione router recupera un messaggio asincrono dalla coda gestita dal protocollo.

[in] SupportFunctions

Puntatore a una struttura SUPPORT_FUNCTIONS . I campi di questa struttura sono puntatori alle funzioni nella gestione router. Queste funzioni consentono al protocollo di accedere alle informazioni che si estendono sui protocolli di routing.

[in] GlobalInfo

Puntatore a globale definito dal protocollo, anziché informazioni di configurazione specifiche dell'interfaccia. Queste informazioni sono private del protocollo di routing.

[in] StructureVersion

Specifica la versione delle strutture di informazioni a cui punta il parametro GlobalInfo . In alcuni casi, questa è uguale alla versione del protocollo di routing.

[in] StructureSize

Specifica le dimensioni di ognuna delle strutture di informazioni a cui fa riferimento il parametro GlobalInfo . Poiché alcune strutture di informazioni contengono membri di lunghezza variabile, il protocollo di routing non è necessariamente in grado di determinare le dimensioni delle informazioni dalla versione.

[in] StructureCount

Specifica un conteggio del numero di strutture di informazioni a cui fa riferimento il parametro GlobalInfo . Questo parametro è sempre uno.

Valore restituito

Se la funzione ha esito positivo e il protocollo è pronto per ricevere informazioni sull'interfaccia, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Descrizione
ERROR_CAN_NOT_COMPLETE	Il tentativo di inizializzare il protocollo di routing non è riuscito.
ERROR_INVALID_PARAMETER	Uno dei parametri a cui punta il parametro GlobalInfo non è valido.

 

 

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	routprot.h

Vedi anche

GetEventMessage

Funzioni di interfaccia del protocollo di routing

Informazioni di riferimento sulle interfacce del protocollo di routing

SUPPORT_FUNCTIONS

StopProtocol