CreateProtocol 函数

CreateProtocol 函数通知网络监视器存在特定的协议分析程序。

语法

HPROTOCOL WINAPI CreateProtocol(
  _In_ LPSTR         ProtocolName,
  _In_ LPENTRYPOINTS lpEntryPoints,
  _In_ DWORD         cbEntryPoints
);

参数

ProtocolName [in]

分析程序将检测的协议的名称。

lpEntryPoints [in]

包含剩余分析程序 DLL 入口点的 ENTRYPOINTS 结构。 有关每个入口点引用的导出函数的列表，请参阅备注。 必须按 ENTRYPOINTS 结构指定的顺序提供入口点。

cbEntryPoints [in]

ENTRYPOINTS 结构的大小。 网络监视器提供了一个ENTRYPOINTS_SIZE宏，可用于指定结构的大小。

返回值

如果函数成功，则返回值是协议的句柄。

如果函数不成功，则返回值为 NULL。

备注

分析程序 DLL 在实现 DllMain 期间调用 CreateProtocol。 当操作系统首次加载分析程序 DLL 时，将调用 CreateProtocol 函数。

lpEntryPoints 参数中引用的入口点包括指向以下导出函数的指针，这些函数必须按此处显示的顺序提供。

• 注册
• 取消注册
• RecognizeFrame
• AttachProperties
• FormatProperties

相关信息	请参阅
什么是分析程序，以及它们如何与网络监视器配合使用。	分析器
如何实现 DllMain 包括一个在 DllMain 中调用 CreateProtocol 的示例。	实现 DllMain

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Netmon.h
库	Nmapi.lib
DLL	Nmapi.dll

另请参阅

DllMain