配置回调函数

配置函数在专家 DLL 中配置专家。

专家必须实现 Configure 函数。 收到函数调用后,专家会显示一个对话框,使用户能够更改任何可配置的项目。

语法

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

parameters

hExpertKey [in]

唯一的专家标识符。

唯一标识符将传回所有特定于专家的网络监视器功能。 请注意,该标识符可能与传递给 Run 函数的专家密钥不同。 请勿从 “配置 ”调用中存储专家密钥。

ppConfig [in, out]

指向入口时 指向 EXPERTCONFIG 结构的指针。

成功退出后,引用的 EXPERTCONFIG 结构包含新的配置数据。

pExpertStartupInfo [in]

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

StartupFlags [in]

指示专家应如何使用 pExpertStartupInfo 参数的标志。 定义的唯一标志是 EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA。 标志指示专家将使用 pExpertStartupInfo 参数,而不是传入的 ppConfig 参数。 通常,从上下文菜单中启动专家时设置标志。

hWnd [in]

父窗口的句柄。 使用句柄打开对话框。

返回值

如果函数成功 (即当前配置存在) ,则返回值为 TRUE

如果函数失败,则返回值为 FALSE

注解

网络监视器使用专家的当前配置调用 Configure 函数(如果存在)。 专家显示一个对话框,你可以使用该对话框更改任何可配置的项目。

传入 ppConfig 并且网络监视器没有为指定专家存储的配置时,参数值可以为 NULL。 在这种情况下, Configure 函数假定 (硬编码的默认值,或者使用启动信息) 打开对话框。

配置数据在 Configure 函数返回时也可以为 NULL,并且传入 NULL。 当网络监视器没有存储的默认值并且用户按下 “取消”时,会出现这种情况。

EXPERTCONFIG 数据结构的开头包括一个专用节,用于存储结构大小信息。 EXPERTCONFIG 结构的大小应包括结构开头显示的保留 DWORD 长度。 例如,如果配置数据需要 20 字节的存储空间,请分配 24 字节来存储数据。 如果 ppConfigNULL则 Configure 函数调用 ExpertAllocMemory 函数来分配大小正确的新配置。 如果缓冲区不足以容纳专家数据,专家应调用 ExpertReallocMemory 函数。

要求

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