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 [仅限桌面应用]
标头	Netmon.h
库	Nmapi.lib
DLL	Nmapi.dll

请参阅

RecognizeFrame