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
pszGroup에서 지정한 작업 패드에서 작업에 대한 이미지로 표시할 이미지를 지정하기 위해 스냅인에서 채워야 하는 MMC_TASK_DISPLAY_OBJECT 구조체입니다.
szText
마우스오버 이미지의 오른쪽에 직접 배치된 텍스트를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 텍스트는 작업의 레이블 역할을 합니다. 이 텍스트는 "새 사용자 추가"와 같은 명령적 작업이어야 합니다.
szHelpString
사용자가 마우스를 마우스 위에 놓거나 작업에 대한 레이블 텍스트를 이동할 때 오른쪽 위 모서리에 배치된 설명 텍스트를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 텍스트는 "새 계정을 만들고, 사서함을 만들고, 사용자가 네트워크에 액세스해야 하는 모든 것을 설정합니다."와 같은 작업에 대한 설명 역할을 합니다.
eActionType
사용자가 작업 패드에서 작업을 클릭할 때 트리거되는 작업 유형을 지정하는 형식 MMC_ACTION_TYPE 값입니다.
다음과 같은 세 가지 유형의 작업이 있습니다.
MMC_ACTION_ID
사용자가 작업을 클릭하면 MMC는 IExtendTaskPad::TaskNotify 를 호출하고 nCommandID 멤버에 지정된 명령 ID를 반환합니다. 이 값을 지정하는 경우 nCommandID 멤버가 필요합니다.
MMC_ACTION_LINK
사용자가 작업을 클릭하면 MMC는 szActionURL로 지정된 링크를 활성화합니다. 이 값을 지정하는 경우 szActionURL 멤버가 필요합니다.
MMC_ACTION_SCRIPT
사용자가 작업을 클릭하면 MMC는 작업 패드 DHTML 페이지의 window.execScript 메서드를 사용하여 szScript에 포함된 스크립트를 실행합니다. 이 값을 지정하는 경우 zScript 멤버가 필요합니다.
nCommandID
eActionType이 MMC_ACTION_ID 경우에만 사용됩니다.
사용자가 작업을 클릭할 때 스냅인으로 반환되는 명령 ID를 지정하는 값입니다.
MMC 가 IExtendTaskPad::TaskNotify를 호출하면 arg 매개 변수에 작업 패드에서 클릭한 작업에 대한 명령 ID가 포함된 VARIANT 구조를 전달합니다. vt 필드는 VT_I4lVal 필드에는 명령 ID가 포함됩니다.
szActionURL
eActionType 이 MMC_ACTION_LINK 경우에만 사용됩니다.
[out] 태스크가 연결되는 URL을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. URL은 정규화되어야 합니다. 문자열에는 URL 대신 스크립트가 포함될 수도 있습니다.
szScript
eActionType이 MMC_ACTION_SCRIPT 경우에만 사용됩니다.
[out] 작업 패드 DHTML 페이지의 window.execScript 메서드를 사용하여 실행할 스크립트가 포함된 null로 종료된 문자열에 대한 포인터입니다. 스크립트 언어를 지정하려면 스크립트 언어로 문자열을 시작합니다.
- "VBSCRIPT:"
- "JSCRIPT:"
- "JAVASCRIPT:"
설명
COM API 함수 CoTaskMemAlloc(또는 이에 해당)을 사용하여 구조에 사용되는 szText, szHelpString, szActionURL 및 szScript 문자열을 할당하고 MMC는 이를 해제합니다.
또한 coTaskMemAlloc(또는 해당)을 사용하여 sDisplayObject 멤버에 지정된 MMC_TASK_DISPLAY_BITMAP 또는 MMC_TASK_DISPLAY_SYMBOL 구조체에 문자열을 할당해야 하며 MMC는 이를 해제합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 머리글 | mmc.h |