GetProtocolFromTable 函数
GetProtocolFromTable 函数根据给定的切换表和值返回协议的句柄。
语法
HPROTOCOL WINAPI GetProtocolFromTable(
_In_ LPHANDOFFTABLE hTable,
_In_ DWORD ItemToFind,
_Out_ PDWORD_PTR lpInstData
);
parameters
-
hTable [in]
-
移交表的句柄。
-
ItemToFind [in]
-
用于在切换表中查找协议的值。 该值必须在协议数据中可用。
-
lpInstData [out]
-
如果切换表中可用,则下一个协议的实例数据。 实例数据的长度不能超过DWORD_PTR。
返回值
如果函数成功,则返回值为协议句柄。
如果函数不成功,则返回值为 NULL。
备注
实现 RecognizeFrame 导出函数时, GetProtocolFromTable 函数用于获取下一个协议的句柄。 如果协议标识了遵循的协议,则调用 GetProtocolFromTable 函数以从下一个协议检索句柄。
实例数据
实例数据可以是长度小于或等于DWORD_PTR的任何数据,也可以是指向不需要由分析程序分配或释放的数据(如原始帧数据)的指针。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
标头 |
|
库 |
|
DLL |
|