structure MPR50_ROUTING_CHARACTERISTICS (routprot.h)

Article
03/15/2023

La structure MPR_ROUTING_CHARACTERISTICS contient des informations utilisées pour inscrire les protocoles de routage auprès du gestionnaire de routeur.

Syntaxe

typedef struct _MPR50_ROUTING_CHARACTERISTICS {
  DWORD               dwVersion;
  DWORD               dwProtocolId;
  DWORD               fSupportedFunctionality;
  PSTART_PROTOCOL     pfnStartProtocol;
  PSTART_COMPLETE     pfnStartComplete;
  PSTOP_PROTOCOL      pfnStopProtocol;
  PGET_GLOBAL_INFO    pfnGetGlobalInfo;
  PSET_GLOBAL_INFO    pfnSetGlobalInfo;
  PQUERY_POWER        pfnQueryPower;
  PSET_POWER          pfnSetPower;
  PADD_INTERFACE      pfnAddInterface;
  PDELETE_INTERFACE   pfnDeleteInterface;
  PINTERFACE_STATUS   pfnInterfaceStatus;
  PGET_INTERFACE_INFO pfnGetInterfaceInfo;
  PSET_INTERFACE_INFO pfnSetInterfaceInfo;
  PGET_EVENT_MESSAGE  pfnGetEventMessage;
  PDO_UPDATE_ROUTES   pfnUpdateRoutes;
  PCONNECT_CLIENT     pfnConnectClient;
  PDISCONNECT_CLIENT  pfnDisconnectClient;
  PGET_NEIGHBORS      pfnGetNeighbors;
  PGET_MFE_STATUS     pfnGetMfeStatus;
  PMIB_CREATE         pfnMibCreateEntry;
  PMIB_DELETE         pfnMibDeleteEntry;
  PMIB_GET            pfnMibGetEntry;
  PMIB_SET            pfnMibSetEntry;
  PMIB_GET_FIRST      pfnMibGetFirstEntry;
  PMIB_GET_NEXT       pfnMibGetNextEntry;
  PMIB_SET_TRAP_INFO  pfnMibSetTrapInfo;
  PMIB_GET_TRAP_INFO  pfnMibGetTrapInfo;
} MPR50_ROUTING_CHARACTERISTICS;

Membres

dwVersion

En entrée, spécifie la version de RRAS en cours d’exécution.

Lors de la sortie, le protocole de routage doit spécifier la version de RRAS dont il a besoin.

Le symbole MS_ROUTER_VERSION dans le fichier d’en-tête Routprot.h est défini comme étant la version RRAS pour une implémentation donnée.

dwProtocolId

Spécifie le protocole de routage que le gestionnaire de routeur demande à la DLL d’inscrire. (Un espace de nom commun est utilisé pour toutes les familles de protocoles.)

fSupportedFunctionality

En entrée, spécifie la fonctionnalité prise en charge par le gestionnaire de routeur.

Lors de la sortie, le protocole de routage doit réinitialiser ces indicateurs pour indiquer le sous-ensemble de fonctionnalités qu’il prend en charge.

Ce paramètre est une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur	Signification
ROUTAGE	Le protocole participe au routage multiprotocole en important des API de gestionnaire de tables de routage. Il existe un gestionnaire de table de routage qui gère une table pour chaque famille de protocoles (par exemple, IP et IPX).
SERVICES	Le protocole assume la responsabilité de la gestion des services (tels que IPX SAP) et fournit des API De gestion des tables de service.
DEMAND_UPDATE_ROUTES	Le protocole est en mesure d’effectuer des mises à jour autostatiques des itinéraires lorsque le gestionnaire de routeur le demande.
DEMAND_UPDATE_SERVICES	Le protocole est en mesure d’effectuer des mises à jour autostatiques des services lorsque le gestionnaire de routeur le demande.

pfnStartProtocol

Pointeur vers une implémentation de la fonction StartProtocol pour ce protocole de routage.

pfnStartComplete

Pointeur vers une implémentation de la fonction StartComplete pour ce protocole de routage.

pfnStopProtocol

Pointeur vers une implémentation de la fonction StopProtocol pour ce protocole de routage.

pfnGetGlobalInfo

Pointeur vers une implémentation de la fonction GetGlobalInfo pour ce protocole de routage.

pfnSetGlobalInfo

Pointeur vers une implémentation de la fonction SetGlobalInfo pour ce protocole de routage.

pfnQueryPower

Pointeur vers une implémentation de la fonction QueryPower pour ce protocole de routage.

pfnSetPower

Pointeur vers une implémentation de la fonction SetPower pour ce protocole de routage.

pfnAddInterface

Pointeur vers une implémentation de la fonction AddInterface pour ce protocole de routage.

pfnDeleteInterface

Pointeur vers une implémentation de la fonction DeleteInterface pour ce protocole de routage.

pfnInterfaceStatus

Pointeur vers une implémentation de la fonction InterfaceStatus pour ce protocole de routage.

pfnGetInterfaceInfo

Pointeur vers une implémentation de la fonction GetInterfaceInfo pour ce protocole de routage.

pfnSetInterfaceInfo

Pointeur vers une implémentation de la fonction SetInterfaceInfo pour ce protocole de routage.

pfnGetEventMessage

Pointeur vers une implémentation de la fonction GetEventMessage pour ce protocole de routage.

pfnUpdateRoutes

Pointeur vers une implémentation de la fonction DoUpdateRoutes pour ce protocole de routage.

pfnConnectClient

Pointeur vers une implémentation de la fonction ConnectClient pour ce protocole de routage.

pfnDisconnectClient

Pointeur vers une implémentation de la fonction DisconnectClient pour ce protocole de routage.

pfnGetNeighbors

Pointeur vers une implémentation de la fonction GetNeighbors pour ce protocole de routage.

pfnGetMfeStatus

Pointeur vers une implémentation de la fonction GetMfeStatus pour ce protocole de routage.

pfnMibCreateEntry

Pointeur vers une implémentation de la fonction MibCreate pour ce protocole de routage.

pfnMibDeleteEntry

Pointeur vers une implémentation de la fonction MibDelete pour ce protocole de routage.

pfnMibGetEntry

Pointeur vers une implémentation de la fonction MibGet pour ce protocole de routage.

pfnMibSetEntry

Pointeur vers une implémentation de la fonction MibSet pour ce protocole de routage.

pfnMibGetFirstEntry

Pointeur vers une implémentation de la fonction MibGetFirst pour ce protocole de routage.

pfnMibGetNextEntry

Pointeur vers une implémentation de la fonction MibGetNext pour ce protocole de routage.

pfnMibSetTrapInfo

Pointeur vers une implémentation de la fonction MibSetTrapInfo pour ce protocole de routage.

pfnMibGetTrapInfo

Pointeur vers une implémentation de la fonction MibGetTrapInfo pour ce protocole de routage.

Remarques

La plupart des membres de cette structure sont des pointeurs vers des fonctions implémentées dans la DLL de protocole de routage. Le protocole de routage remplit les valeurs d’adresse de ces pointeurs lors d’un appel à la fonction RegisterProtocol .

Pour obtenir une description complète d’une fonction particulière pointée vers l’un des membres de la structure, consultez la page de référence de cette fonction.

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]
En-tête	routprot.h

Voir aussi

Identificateurs de protocole

RegisterProtocol

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

Structures d’interface de protocole de routage

Partager via