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

另请参阅

IEnumTASK

IExtendTaskPad