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

MPR_ROUTING_CHARACTERISTICS

MPR_SERVICE_CHARACTERISTICS

Fonctions d’interface de protocole de routage

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