PSTART_PROTOCOL回调函数 (routprot.h)
StartProtocol 函数初始化路由协议的功能。 路由器管理器使用此函数传递路由协议全局配置参数和一组 API 入口点。 协议使用这些入口点来调用路由器管理器。
语法
PSTART_PROTOCOL PstartProtocol;
DWORD PstartProtocol(
[in] HANDLE NotificationEvent,
[in] PSUPPORT_FUNCTIONS SupportFunctions,
[in] LPVOID GlobalInfo,
[in] ULONG StructureVersion,
[in] ULONG StructureSize,
[in] ULONG StructureCount
)
{...}
参数
[in] NotificationEvent
事件对象的句柄。 当路由协议希望路由器管理器从协议维护的队列中检索异步消息时，路由协议会发出此事件信号。
[in] SupportFunctions
指向 SUPPORT_FUNCTIONS 结构的指针。 此结构的字段是指向路由器管理器中函数的指针。 这些函数允许协议访问跨路由协议的信息。
[in] GlobalInfo
指向协议定义的全局的指针，而不是特定于接口的配置信息。 此信息是路由协议的专用信息。
[in] StructureVersion
指定 GlobalInfo 参数指向的信息结构的版本。 在某些情况下，这等于路由协议的版本。
[in] StructureSize
指定 GlobalInfo 参数指向的每个信息结构的大小。 由于某些信息结构包含可变长度成员，路由协议不一定能够确定版本信息的大小。
[in] StructureCount
指定 GlobalInfo 参数指向的信息结构的数量计数。 此参数始终为 1。
返回值
如果函数成功，并且协议已准备好接收接口信息，则返回值NO_ERROR。
如果函数失败，则返回值为以下错误代码之一。
| 值 | 说明 |
|---|---|
|
尝试初始化路由协议失败。 |
|
GlobalInfo 参数指向的参数之一无效。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | routprot.h |