MMC_TASK 结构 (mmc.h)

MMC 1.1 中引入了MMC_TASK结构。

MMC_TASK 结构由 IEnumTASK::Next 方法填充,以指定在任务板上设置单个任务所需的所有数据。

语法

typedef struct _MMC_TASK {
  MMC_TASK_DISPLAY_OBJECT sDisplayObject;
  LPOLESTR                szText;
  LPOLESTR                szHelpString;
  MMC_ACTION_TYPE         eActionType;
  union {
    LONG_PTR nCommandID;
    LPOLESTR szActionURL;
    LPOLESTR szScript;
  };
} MMC_TASK;

成员

sDisplayObject

MMC_TASK_DISPLAY_OBJECT 结构,管理单元必须填充该结构,以指定要显示为 pszGroup 指定的任务板中的任务的图像的图像。

szText

指向以 null 结尾的字符串的指针,该字符串包含直接放置在鼠标悬停图像右侧的文本。 此文本用作任务的标签。 此文本应为命令性操作,例如“添加新用户”。

szHelpString

指向以 null 结尾的字符串的指针,该字符串包含当用户将鼠标悬停在鼠标悬停图像或任务标签文本上时放置在右上角的描述性文本。 此文本用作任务的说明,例如“创建新帐户、创建邮箱并设置用户必须访问网络的所有内容”。

eActionType

类型的值MMC_ACTION_TYPE,指定当用户单击任务板上的任务时触发的操作类型。

有三种类型的操作:

MMC_ACTION_ID

当用户单击任务时,MMC 调用 IExtendTaskPad::TaskNotify 并返回 nCommandID 成员中指定的命令 ID。 如果指定此值,则需要 nCommandID 成员。

当用户单击任务时,MMC 将激活 szActionURL 指定的链接。 如果指定此值,则需要 szActionURL 成员。

MMC_ACTION_SCRIPT

当用户单击任务时,MMC 将使用任务板 DHTML 页上的 window.execScript 方法执行 szScript 中包含的脚本。 如果指定此值,则需要 zScript 成员。

nCommandID

仅在MMC_ACTION_IDeActionType 时才使用。

一个 值,该值指定当用户单击任务时返回到管理单元的命令 ID。

当 MMC 调用 IExtendTaskPad::TaskNotify 时,它会向 arg 参数传递 VARIANT 结构,其中包含在任务板上单击的任务的命令 ID。 vt 字段VT_I4,lVal 字段包含命令 ID。

szActionURL

仅在MMC_ACTION_LINK eActionType 时才使用。

[out]指向以 null 结尾的字符串的指针,该字符串包含任务链接到的 URL。 URL 必须完全限定。 字符串还可以包含脚本而不是 URL。

szScript

仅在MMC_ACTION_SCRIPTeActionType 时才使用。

[out]指向以 null 结尾的字符串的指针,该字符串包含要使用 taskpad DHTML 页上的 window.execScript 方法运行的脚本。 若要指定脚本语言,请使用脚本语言开头字符串:

  • “VBSCRIPT:”
  • “JSCRIPT:”
  • “JAVASCRIPT:”
如果未指定脚本语言,则默认语言为 JavaScript。

注解

使用 COM API 函数 CoTaskMemAlloc (或等效) 分配结构中使用的 szTextszHelpStringszActionURLszScript 字符串,MMC 将释放它们。

还应使用 CoTaskMemAllocsDisplayObject 成员中指定的 MMC_TASK_DISPLAY_BITMAPMMC_TASK_DISPLAY_SYMBOL 结构中分配 (字符串,或者等效) ,MMC 将释放它们。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
标头 mmc.h

另请参阅

IEnumTASK::Next

IExtendTaskPad::TaskNotify

MMC_ACTION_TYPE

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL