配置回调函数

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

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

语法

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

参数

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 数据结构的开头包含存储结构大小信息的 Private 部分。 EXPERTCONFIG 结构的大小应包括结构开头显示的保留 DWORD 长度。 例如，如果配置数据需要 20 字节的存储空间，请分配 24 个字节来存储数据。 如果 ppConfig 为 NULL， 则 Configure 函数会调用 ExpertAllocMemory 函数来分配大小正确的新配置。 如果缓冲区不足以保存专家数据，专家应调用 ExpertReallocMemory 函数。

要求

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