PSTART_PROTOCOL fonction de rappel (routprot.h)

Article
03/01/2024

La fonction StartProtocol initialise les fonctionnalités du protocole de routage. Le gestionnaire de routeur utilise cette fonction pour passer les paramètres de configuration globale du protocole de routage et un ensemble de points d’entrée d’API. Le protocole utilise ces points d’entrée pour appeler le gestionnaire de routeur.

Syntaxe

PSTART_PROTOCOL PstartProtocol;

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

Paramètres

[in] NotificationEvent

Gérez un objet d’événement. Le protocole de routage signale cet événement lorsqu’il souhaite que le gestionnaire de routeur récupère un message asynchrone à partir de la file d’attente gérée par le protocole.

[in] SupportFunctions

Pointeur vers une structure SUPPORT_FUNCTIONS . Les champs de cette structure sont des pointeurs vers des fonctions dans le gestionnaire de routeur. Ces fonctions permettent au protocole d’accéder aux informations qui couvrent les protocoles de routage.

[in] GlobalInfo

Pointeur vers les informations de configuration globales définies par le protocole, par opposition aux informations de configuration spécifiques à l’interface. Ces informations sont privées au protocole de routage.

[in] StructureVersion

Spécifie la version des structures d’informations pointées vers le paramètre GlobalInfo . Dans certains cas, cela est égal à la version du protocole de routage.

[in] StructureSize

Spécifie la taille de chacune des structures d’informations pointées par le paramètre GlobalInfo . Étant donné que certaines structures d’informations contiennent des membres de longueur variable, le protocole de routage n’est pas nécessairement en mesure de déterminer la taille des informations à partir de la version.

[in] StructureCount

Spécifie le nombre de structures d’informations pointées par le paramètre GlobalInfo . Ce paramètre en est toujours un.

Valeur retournée

Si la fonction réussit et que le protocole est prêt à recevoir des informations d’interface, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Description
ERROR_CAN_NOT_COMPLETE	La tentative d’initialisation du protocole de routage a échoué.
ERROR_INVALID_PARAMETER	L’un des paramètres pointés par le paramètre GlobalInfo n’est pas valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	routprot.h

Voir aussi

GetEventMessage

Fonctions d’interface de protocole de routage

Informations de référence sur l’interface de protocole de routage

SUPPORT_FUNCTIONS

StopProtocol

Partager via