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 参数中引用的入口点包括指向以下导出函数的指针，这些函数必须按此处显示的顺序提供。
| 相关信息 | 请参阅 |
|---|---|
| 什么是分析程序，以及它们如何与网络监视器配合使用。 | 分析器 |
| 如何实现 DllMain 包括一个在 DllMain 中调用 CreateProtocol 的示例。 | 实现 DllMain |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|