struttura MPR40_SERVICE_CHARACTERISTICS (stm.h)

Articolo
08/26/2023

La struttura MPR_SERVICE_CHARACTERISTICS contiene informazioni usate per registrare un protocollo di routing con la gestione router.

Sintassi

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;

Members

dwVersion

In input, specifica la versione di RRAS attualmente in esecuzione.

Nell'output, il protocollo di routing deve specificare la versione di RRAS richiesta.

Il simbolo MS_ROUTER_VERSION nel file di intestazione Routprot.h è definito come la versione RRAS per una determinata implementazione.

dwProtocolId

Specifica il protocollo di routing richiesto dalla gestione router per la registrazione della DLL. Viene usato uno spazio dei nomi comune per tutte le famiglie di protocolli.

fSupportedFunctionality

In input, specifica la funzionalità supportata dalla gestione router.

Nell'output, il protocollo di routing deve reimpostare questi flag per indicare il subset di funzionalità supportate. Se questo protocollo di routing non fornisce servizi, fSupportedFunctionality deve essere zero.

Questo parametro è uno o più dei valori seguenti.

Valore	Significato
ROUTING	Il protocollo partecipa al routing multi-protocollo importando le API di gestione tabelle di routing. È disponibile un gestore tabelle di routing che gestisce una tabella per ogni famiglia di protocolli, ad esempio IP e IPX.
SERVIZI	Il protocollo assume la responsabilità della gestione dei servizi (ad esempio IPX SAP) e fornisce api di gestione tabelle dei servizi.
DEMAND_UPDATE_ROUTES	Il protocollo è in grado di eseguire aggiornamenti automatici delle route quando richiesto dal gestore router.
DEMAND_UPDATE_SERVICES	Il protocollo è in grado di eseguire aggiornamenti automatici dei servizi quando richiesto dal gestore router.

pfnIsService

Puntatore a un'implementazione della funzione IsService per questo protocollo di routing.

pfnUpdateServices

pfnCreateServiceEnumerationHandle

Puntatore a un'implementazione della funzione CreateServiceEnumerationHandle per questo protocollo di routing.

pfnEnumerateGetNextService

Puntatore a un'implementazione della funzione EnumerateGetNextService per questo protocollo di routing.

pfnCloseServiceEnumerationHandle

Puntatore a un'implementazione della funzione CloseServiceEnumerationHandle per questo protocollo di routing.

pfnGetServiceCount

Puntatore a un'implementazione della funzione GetServiceCount per questo protocollo di routing.

pfnCreateStaticService

Puntatore a un'implementazione della funzione CreateStaticService per questo protocollo di routing.

pfnDeleteStaticService

Puntatore a un'implementazione della funzione DeleteStaticService per questo protocollo di routing.

pfnBlockConvertServicesToStatic

Puntatore a un'implementazione della funzione BlockConvertServicesToStatic per questo protocollo di routing.

pfnBlockDeleteStaticServices

Puntatore a un'implementazione della funzione BlockDeleteStaticServices per questo protocollo di routing.

pfnGetFirstOrderedService

Puntatore a un'implementazione della funzione GetFirstOrderedService per questo protocollo di routing.

pfnGetNextOrderedService

Puntatore a un'implementazione della funzione GetNextOrderedService per questo protocollo di routing.

Commenti

I membri di questa struttura sono puntatori alle funzioni di gestione tabelle dei servizi implementate nella DLL del protocollo di routing. Il protocollo di routing inserisce i valori degli indirizzi per questi puntatori durante una chiamata alla funzione RegisterProtocol .

Solo le DLL del protocollo di routing che supportano i servizi devono compilare la struttura MPR_SERVICE_CHARACTERISTICS .

Per una descrizione completa di una determinata funzione a cui punta uno dei membri della struttura, vedere la pagina di riferimento per tale funzione.

Per usare questa struttura, l'utente deve aggiungere -DMPR50=1 ai flag del compilatore.