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_ACTION_LINK
當使用者按下工作時,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:”
備註
配置結構中使用的 szText、szHelpString、szActionURL 和 szScript 字串搭配 COM API 函式 CoTaskMemAlloc (或對等的) ,MMC 將會釋放它們。
您也應該將字串配置在 sDisplayObject 成員中指定的MMC_TASK_DISPLAY_BITMAP或MMC_TASK_DISPLAY_SYMBOL結構中,並搭配 CoTaskMemAlloc (或對等的) ,而 MMC 將會釋放這些字串。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
標頭 | mmc.h |