配置回调函数
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 [仅限桌面应用] |
| 标头 |
|