PREGISTER_PROTOCOL回调函数 (routprot.h)

RegisterProtocol 函数向路由器管理器注册路由协议。 它还会通知路由器管理器路由协议支持的功能。

语法

PREGISTER_PROTOCOL PregisterProtocol;

DWORD PregisterProtocol(
  [in, out] PMPR_ROUTING_CHARACTERISTICS pRoutingChar,
  [in, out] PMPR_SERVICE_CHARACTERISTICS pServiceChar
)
{...}

参数

[in, out] pRoutingChar

输入时，指向 MPR_ROUTING_CHARACTERISTICS 结构的指针。

在输出时，接收指向为路由协议实现的函数的指针。

有关如何将其与 RegisterProtocol 函数一起使用的详细信息，请参阅MPR_ROUTING_CHARACTERISTICS结构的参考页。

[in, out] pServiceChar

输入时，指针指向 MPR_SERVICE_CHARACTERISTICS 结构。

在输出时，接收指向为路由协议实现的函数的指针。

有关如何将其与 RegisterProtocol 函数配合使用的详细信息，请参阅MPR_SERVICE_CHARACTERISTICS结构的参考页。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值ERROR_NOT_SUPPORTED。

注解

所有路由协议 DLL 都必须填充 MPR_ROUTING_CHARACTERISTICS 结构的值。

提供服务的路由协议 DLL 必须填充 MPR_SERVICE_CHARACTERISTICS 结构的值。 如果路由协议 DLL 未提供服务，则应为此结构的 fSupportedFunctionality 成员填充零，但不需要为其他成员填充值。

路由协议在用户模式 DLL 中实现。 单个 DLL 可以实现多个路由协议。 因此，路由器管理器可能会多次调用 RegisterProtocol ，针对 DLL 中实现的每个路由协议调用一次。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	routprot.h

另请参阅

MPR_ROUTING_CHARACTERISTICS

MPR_SERVICE_CHARACTERISTICS

路由协议接口函数

路由协议接口参考