共用方式為


MMC_TASK結構 (mmc.h)

MMC_TASK 結構是在 MMC 1.1 中引進。

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 成員中指定的命令標識碼。 如果您指定此值,則需要 nCommandID 成員。

當使用者按下工作時,MMC 會啟動 szActionURL 所指定的連結。 如果您指定此值,則需要 szActionURL 成員。

MMC_ACTION_SCRIPT

當使用者按下工作時,MMC 會在任務板 DHTML 頁面上使用 window.execScript 方法執行 szScript 中包含的腳本。 如果您指定此值, 則需要 zScript 成員。

nCommandID

只有在 eActionTypeMMC_ACTION_ID時才使用。

值,指定使用者按下工作時傳回至嵌入式管理單元的命令標識碼。

當 MMC 呼叫 IExtendTaskPad::TaskNotify 時,它會傳入 arg 參數 ARG結構, 其中包含在任務板上按兩下之工作的命令標識符。 vt 欄位VT_I4,lVal 欄位包含命令標識碼。

szActionURL

只有在 eActionTypeMMC_ACTION_LINK時才使用。

[out]Null 終止字串的指標,其中包含工作連結的URL。 URL 必須完整。 字串也可以包含腳本,而不是 URL。

szScript

只有在 eActionType是MMC_ACTION_SCRIPT時才使用。

[out]Null 終止字串的指標,其中包含在工作板 DHTML 頁面上使用 window.execScript 方法執行的腳本。 若要指定文稿語言,請使用文稿語言開始字串:

  • “VBSCRIPT:”
  • “JSCRIPT:”
  • “JAVASCRIPT:”
如果未指定任何腳本語言,則默認語言為 JavaScript。

備註

配置結構中使用的 szTextszHelpString、szActionURLszScript 字串搭配 COM API 函式 CoTaskMemAlloc (或對等的) ,MMC 將會釋放它們。

您也應該將字串配置在 sDisplayObject 成員中指定的MMC_TASK_DISPLAY_BITMAPMMC_TASK_DISPLAY_SYMBOL結構中,並搭配 CoTaskMemAlloc (或對等的) ,而 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