PREGISTER_PROTOCOL fonction de rappel (routprot.h)
La fonction RegisterProtocol inscrit le protocole de routage auprès du gestionnaire de routeur. Il informe également le gestionnaire de routeur des fonctionnalités que le protocole de routage prend en charge.
Syntaxe
PREGISTER_PROTOCOL PregisterProtocol;
DWORD PregisterProtocol(
[in, out] PMPR_ROUTING_CHARACTERISTICS pRoutingChar,
[in, out] PMPR_SERVICE_CHARACTERISTICS pServiceChar
)
{...}
Paramètres
[in, out] pRoutingChar
Lors de l’entrée, pointeur vers une structure MPR_ROUTING_CHARACTERISTICS .
Lors de la sortie, reçoit des pointeurs vers les fonctions implémentées pour le protocole de routage.
Pour plus d’informations sur son utilisation avec la fonction RegisterProtocol, consultez la page de référence de la structure MPR_ROUTING_CHARACTERISTICS.
[in, out] pServiceChar
Lors de l’entrée, pointeur vers une structure MPR_SERVICE_CHARACTERISTICS .
Lors de la sortie, reçoit des pointeurs vers les fonctions implémentées pour le protocole de routage.
Pour plus d’informations sur son utilisation avec la fonction RegisterProtocol, consultez la page de référence de la structure MPR_SERVICE_CHARACTERISTICS.
Valeur retournée
Si la fonction réussit, la valeur de retour est NO_ERROR.
Si la fonction échoue, la valeur de retour est ERROR_NOT_SUPPORTED.
Remarques
Toutes les DLL de protocole de routage doivent renseigner des valeurs pour la structure MPR_ROUTING_CHARACTERISTICS .
Les DLL de protocole de routage qui fournissent des services doivent renseigner des valeurs pour la structure MPR_SERVICE_CHARACTERISTICS . Si une DLL de protocole de routage ne fournit pas de services, elle doit remplir zéro pour le membre fSupportedFunctionality de cette structure, mais n’a pas besoin de renseigner les valeurs pour les autres membres.
Les protocoles de routage sont implémentés dans les DLL en mode utilisateur. Une seule DLL peut implémenter plusieurs protocoles de routage. Par conséquent, le gestionnaire de routeur peut appeler RegisterProtocol plusieurs fois, une fois pour chaque protocole de routage implémenté dans la DLL.
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
Fonctions d’interface de protocole de routage
Informations de référence sur l’interface de protocole de routage