структура MMC_TASK (mmc.h)

Статья
08/24/2023

Структура 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 выполняет скрипт, содержащийся в szScript , с помощью метода window.execScript на странице DHTML панели задач. Если указать это значение, требуется элемент zScript .

nCommandID

Используется, только если eActionType имеет MMC_ACTION_ID.

Значение типа , указывающее идентификатор команды, возвращаемый оснастке, когда пользователь щелкает задачу.

Когда MMC вызывает IExtendTaskPad::TaskNotify, она передает параметру arg структуру VARIANT , содержащую идентификатор команды для задачи, щелкнув ее на панели задач. Поле vtVT_I4, а поле lVal содержит идентификатор команды.

szActionURL

Используется, только если eActionType имеет MMC_ACTION_LINK.

[out] Указатель на строку, завершающуюся null, которая содержит URL-адрес, с которым связана задача. URL-адрес должен быть полным. Строка также может содержать скрипт вместо URL-адреса.

szScript

Используется, только если eActionType имеет MMC_ACTION_SCRIPT.

[out] Указатель на строку, завершающуюся значением NULL, которая содержит скрипт для выполнения с помощью метода window.execScript на странице DHTML панели задач. Чтобы указать язык скрипта, начните строку с языка скрипта:

"VBSCRIPT:"
"JSCRIPT:"
"JAVASCRIPT:"

Если язык скриптов не указан, языком по умолчанию является JavaScript.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Верхняя часть	mmc.h