MPR40_SERVICE_CHARACTERISTICS structure (stm.h)

La structure MPR_SERVICE_CHARACTERISTICS contient des informations utilisées pour inscrire un protocole de routage auprès du gestionnaire de routeur.

Syntaxe

typedef struct _MPR40_SERVICE_CHARACTERISTICS {
  DWORD                              dwVersion;
  DWORD                              dwProtocolId;
  DWORD                              fSupportedFunctionality;
  PIS_SERVICE                        pfnIsService;
  PDO_UPDATE_SERVICES                pfnUpdateServices;
  PCREATE_SERVICE_ENUMERATION_HANDLE pfnCreateServiceEnumerationHandle;
  PENUMERATE_GET_NEXT_SERVICE        pfnEnumerateGetNextService;
  PCLOSE_SERVICE_ENUMERATION_HANDLE  pfnCloseServiceEnumerationHandle;
  PGET_SERVICE_COUNT                 pfnGetServiceCount;
  PCREATE_STATIC_SERVICE             pfnCreateStaticService;
  PDELETE_STATIC_SERVICE             pfnDeleteStaticService;
  PBLOCK_CONVERT_SERVICES_TO_STATIC  pfnBlockConvertServicesToStatic;
  PBLOCK_DELETE_STATIC_SERVICES      pfnBlockDeleteStaticServices;
  PGET_FIRST_ORDERED_SERVICE         pfnGetFirstOrderedService;
  PGET_NEXT_ORDERED_SERVICE          pfnGetNextOrderedService;
} MPR40_SERVICE_CHARACTERISTICS;

Membres

dwVersion

Lors de l’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

Lors de l’entrée, spécifie les fonctionnalités que le gestionnaire de routeur prend en charge.

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. Si ce protocole de routage ne fournit pas de services, fSupportedFunctionality doit être égal à zéro.

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

Valeur	Signification
ROUTAGE	Le protocole participe au routage multiprotocole en important les API du gestionnaire de tables de routage. Il existe un gestionnaire de tables 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 (comme 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.

pfnIsService

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

pfnUpdateServices

pfnCreateServiceEnumerationHandle

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

pfnEnumerateGetNextService

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

pfnCloseServiceEnumerationHandle

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

pfnGetServiceCount

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

pfnCreateStaticService

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

pfnDeleteStaticService

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

pfnBlockConvertServicesToStatic

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

pfnBlockDeleteStaticServices

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

pfnGetFirstOrderedService

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

pfnGetNextOrderedService

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

Remarques

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

Seules les DLL de protocole de routage qui prennent en charge les services doivent remplir la structure MPR_SERVICE_CHARACTERISTICS .

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

Pour utiliser cette structure, l’utilisateur doit ajouter -DMPR50=1 aux indicateurs du compilateur.

Configuration requise

Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	stm.h

Voir aussi

MPR_ROUTING_CHARACTERISTICS

Identificateurs de protocole

RegisterProtocol

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

Structures d’interface de protocole de routage