estructura MPR40_SERVICE_CHARACTERISTICS (stm.h)

La estructura MPR_SERVICE_CHARACTERISTICS contiene información utilizada para registrar un protocolo de enrutamiento con el administrador de enrutadores.

Sintaxis

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;

Miembros

dwVersion

En la entrada, especifica la versión de RRAS que se está ejecutando actualmente.

En la salida, el protocolo de enrutamiento debe especificar la versión de RRAS que requiere.

El símbolo MS_ROUTER_VERSION en el archivo de encabezado Routprot.h se define como la versión RRAS para una implementación determinada.

dwProtocolId

Especifica el protocolo de enrutamiento que el administrador de enrutadores solicita al archivo DLL que se registre. (Se usa un espacio de nombres común para todas las familias de protocolos).

fSupportedFunctionality

En la entrada, especifica la funcionalidad que admite el administrador de enrutadores.

En la salida, el protocolo de enrutamiento debe restablecer estas marcas para indicar el subconjunto de funcionalidades que admite. Si este protocolo de enrutamiento no proporciona servicios, fSupportedFunctionality debe ser cero.

Este parámetro es uno o varios de los valores siguientes.

Value	Significado
ENRUTAMIENTO	El protocolo participa en el enrutamiento de varios protocolos importando las API del administrador de tablas de enrutamiento. Hay un administrador de tablas de enrutamiento que mantiene una tabla para cada familia de protocolos (como IP e IPX).
SERVICIOS	El protocolo asume la responsabilidad de administrar servicios (como IPX SAP) y proporciona las API de Service Table Management.
DEMAND_UPDATE_ROUTES	El protocolo es capaz de realizar actualizaciones autostáticas de rutas cuando lo solicite el administrador del enrutador.
DEMAND_UPDATE_SERVICES	El protocolo es capaz de realizar actualizaciones autostáticas de los servicios cuando lo solicite el administrador del enrutador.

pfnIsService

Puntero a una implementación de la función IsService para este protocolo de enrutamiento.

pfnUpdateServices

pfnCreateServiceEnumerationHandle

Puntero a una implementación de la función CreateServiceEnumerationHandle para este protocolo de enrutamiento.

pfnEnumerateGetNextService

Puntero a una implementación de la función EnumerateGetNextService para este protocolo de enrutamiento.

pfnCloseServiceEnumerationHandle

Puntero a una implementación de la función CloseServiceEnumerationHandle para este protocolo de enrutamiento.

pfnGetServiceCount

Puntero a una implementación de la función GetServiceCount para este protocolo de enrutamiento.

pfnCreateStaticService

Puntero a una implementación de la función CreateStaticService para este protocolo de enrutamiento.

pfnDeleteStaticService

Puntero a una implementación de la función DeleteStaticService para este protocolo de enrutamiento.

pfnBlockConvertServicesToStatic

Puntero a una implementación de la función BlockConvertServicesToStatic para este protocolo de enrutamiento.

pfnBlockDeleteStaticServices

Puntero a una implementación de la función BlockDeleteStaticServices para este protocolo de enrutamiento.

pfnGetFirstOrderedService

Puntero a una implementación de la función GetFirstOrderedService para este protocolo de enrutamiento.

pfnGetNextOrderedService

Puntero a una implementación de la función GetNextOrderedService para este protocolo de enrutamiento.

Comentarios

Los miembros de esta estructura son punteros a las funciones de Service Table Management implementadas en el archivo DLL del protocolo de enrutamiento. El protocolo de enrutamiento rellena los valores de dirección de estos punteros durante una llamada a la función RegisterProtocol .

Solo los archivos DLL de protocolo de enrutamiento que admiten servicios deben rellenar la estructura de MPR_SERVICE_CHARACTERISTICS .

Para obtener una descripción completa de una función determinada a la que apunta uno de los miembros de la estructura, consulte la página de referencia de esa función.

Para usar esta estructura, el usuario debe agregar -DMPR50=1 a las marcas del compilador.

Requisitos

Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	stm.h

Consulte también

MPR_ROUTING_CHARACTERISTICS

Identificadores de protocolo

RegisterProtocol

Referencia de interfaz de protocolo de enrutamiento

Estructuras de interfaz de protocolo de enrutamiento