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 應為零。

此參數是下列一或多個值。

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 新增至編譯器旗標。

需求

另請參閱

MPR_ROUTING_CHARACTERISTICS

通訊協定識別碼

RegisterProtocol

路由通訊協定介面參考

路由通訊協定介面結構