运行回调函数

专家必须实现 Run 函数。 网络监视器调用 Run 函数来启动专家 DLL 中的专家。

语法

BOOL WINAPI Run(
  _In_ HEXPERTKEY         hExpertKey,
  _In_ PEXPERTCONFIG      pConfig,
  _In_ PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_ DWORD              StartupFlags,
  _In_ HWND               hWndParent
);

参数

hExpertKey [in]

传回所有专家特定网络监视器函数的专家的唯一标识符。

注意

hExpertKey 标识符可以传递与 Configure 函数传递的专家密钥不同的专家密钥。

pConfig [in]

指向现有配置的指针。 pConfig 参数可以为 NULL，这意味着专家可以使用硬编码的默认值或 pExpertStartupInfo 参数引用的启动信息运行。

pExpertStartupInfo [in]

指向专家启动时具有焦点的捕获元素的指针。

StartupFlags [in]

专家应如何使用 pExpertStartupInfo 参数的指示器。

定义的唯一标志是：

值	含义
EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA。	此标志指示专家使用 pExpertStartupInfo 参数，而不使用 pConfig 参数。 通常，当专家可以从鼠标右键单击开始时设置此标志。 如果未设置标志，则可能会发生以下两种情况：专家不从鼠标右键单击开始，或者专家从鼠标右键单击开始，然后用户对其进行配置。

hWndParent [in]

父 (的 hWnd 参数通常为网络监视器用户界面) 。

返回值

如果函数成功 (也就是说，如果专家开始) ，则返回值为 TRUE。

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

备注

运行时，专家会循环访问捕获文件中的帧，并生成报告或创建显示问题的事件。

要求

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