IExtendTaskPad::TaskNotify 方法 (mmc.h)
IExtendTaskPad::TaskNotify 方法使 MMC 能够在任务扩展时通知管理单元。 如果任务板是列表视图任务板,则当扩展列表视图按钮时,MMC 还会调用 IExtendTaskPad::TaskNotify 。
语法
HRESULT TaskNotify(
[in] IDataObject *pdo,
[in] VARIANT *arg,
[in] VARIANT *param
);
parameters
[in] pdo
指向拥有任务板的范围项的数据对象的指针。 如果管理单元拥有显示任务板的项,则 pdo 是指向该项目的指针。 如果管理单元正在扩展另一个管理单元的任务板,则 pdo 是指向管理单元中拥有任务板的项的指针。
[in] arg
指向 VARIANT 结构的指针,该结构包含从任务板上的 CIC 控件传回的信息。
使用 MMC 任务板模板的任务板
对于 MMC 提供的任务板,VARIANT 结构包含已设置的任务板任务或列表视图按钮的命令 ID。
vt 字段VT_I4,lVal 字段包含已设置的任务板任务或列表视图按钮的命令 ID。 列表视图按钮仅适用于列表视图任务板。
任务命令 ID 在 MMC_TASK 结构的 nCommandID 成员中指定,该成员在 MMC 在设置任务板期间检索该任务的信息时在 IEnumTASK::Next 方法中传递。
列表视图按钮是在 MMC_LISTPAD_INFO 结构的 szButtonText 成员中指定的按钮,该按钮在 MMC 设置列表视图任务板时调用的 IExtendTaskPad::GetListPadInfo 方法中传递。 列表视图按钮命令 ID 在 MMC_LISTPAD_INFO 的 nCommandID 成员中指定。
使用自定义 HTML 页面的任务板
对于自定义任务板,VARIANT 结构可以包含自定义 HTML 页面上的脚本希望通过 CIC 对象 TaskNotify 方法传递的任何数据
[in] param
指向 VARIANT 结构的指针,该结构包含从任务板上的 CIC 控件传回的信息。
使用 MMC 任务板模板的任务板将忽略此参数。 但是,自定义任务板可以使用它将附加值传递回管理单元。
返回值
此方法可以返回其中一个值。
注解
管理单元可以使用 pdo 指针标识拥有任务板的范围项;然后,它可以通过 arg 参数中返回的 VARIANT 值来标识任务。 如果任务板是列表视图任务板,则管理单元可以使用 IResultData 接口在结果列表中识别选定项 (或支持多重选择) 的项。 根据此数据,管理单元可以对相应的对象执行相应的操作。
如果为列表视图任务板提供了任务板列表视图按钮,则管理单元可以通过 arg 参数中返回的 VARIANT 值来标识特定任务板的按钮。
自定义任务板可以传递它确定应在 arg 和 param 参数中发送的任何值。
要求
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | mmc.h |