通过

MPR40_SERVICE_CHARACTERISTICS结构 (stm.h)

  • 项目

MPR_SERVICE_CHARACTERISTICS 结构包含用于向路由器管理器注册路由协议的信息。

语法

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;

成员

dwVersion

输入时，指定当前运行的 RRAS 版本。

在输出时，路由协议应指定所需的 RRAS 版本。

头文件 Routprot.h 中的符号MS_ROUTER_VERSION定义为给定实现的 RRAS 版本。

dwProtocolId

指定路由器管理器请求 DLL 注册的路由协议。 (公用名称空间用于所有协议系列。)

fSupportedFunctionality

输入时，指定路由器管理器支持的功能。

在输出时，路由协议应重置这些标志，以指示它支持的功能子集。 如果此路由协议未提供服务， fSupportedFunctionality 应为零。

此参数是以下一个或多个值。

值 含义
路由
 协议通过导入路由表管理器 API 参与多协议路由。 有一个路由表管理器为每个协议系列 (（例如 IP 和 IPX) ）维护一个表。
服务
 该协议负责管理服务 (，例如 IPX SAP) ，并提供服务表管理 API。
DEMAND_UPDATE_ROUTES
 当路由器管理器请求时，协议能够执行路由的自动静态更新。
DEMAND_UPDATE_SERVICES
 当路由器管理器请求时，该协议能够执行服务的自动静态更新。

pfnIsService

指向此路由协议的 IsService 函数实现的指针。

pfnUpdateServices

pfnCreateServiceEnumerationHandle

指向此路由协议的 CreateServiceEnumerationHandle 函数实现的指针。

pfnEnumerateGetNextService

指向此路由协议的 EnumerateGetNextService 函数实现的指针。

pfnCloseServiceEnumerationHandle

指向此路由协议的 CloseServiceEnumerationHandle 函数实现的指针。

pfnGetServiceCount

指向此路由协议的 GetServiceCount 函数实现的指针。

pfnCreateStaticService

指向此路由协议的 CreateStaticService 函数实现的指针。

pfnDeleteStaticService

指向此路由协议 的 DeleteStaticService 函数实现的指针。

pfnBlockConvertServicesToStatic

指向此路由协议的 BlockConvertServicesToStatic 函数实现的指针。

pfnBlockDeleteStaticServices

指向此路由协议的 BlockDeleteStaticServices 函数实现的指针。

pfnGetFirstOrderedService

指向此路由协议的 GetFirstOrderedService 函数实现的指针。

pfnGetNextOrderedService

指向此路由协议的 GetNextOrderedService 函数实现的指针。

注解

此结构的成员是指向路由协议 DLL 中实现的服务表管理功能的指针。 路由协议在调用 RegisterProtocol 函数期间填充这些指针的地址值。

仅支持服务的路由协议 DLL 需要填充 MPR_SERVICE_CHARACTERISTICS 结构。

有关某个结构成员指向的特定函数的完整说明，请参阅该函数的参考页。

若要使用此结构，用户应向编译器标志添加 -DMPR50=1。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 stm.h

另请参阅

MPR_ROUTING_CHARACTERISTICS

协议标识符

RegisterProtocol

路由协议接口参考

路由协议接口结构