Метод IExtendTaskPad::TaskNotify (mmc.h)
Метод IExtendTaskPad::TaskNotify позволяет MMC уведомлять оснастку о продлении задачи. Если панель задач является панелью задач представления списка, MMC также вызывает IExtendTaskPad::TaskNotify при расширении кнопки представления списка.
Синтаксис
HRESULT TaskNotify(
[in] IDataObject *pdo,
[in] VARIANT *arg,
[in] VARIANT *param
);
Параметры
[in] pdo
Указатель на объект данных для элемента область, которому принадлежит панель задач. Если оснастка владеет элементом, отображающим панель задач, pdo является указателем на этот элемент. Если оснастка расширяет панель задач другой оснастки, pdo — это указатель на элемент оснастки, которому принадлежит панель задач.
[in] arg
Указатель на структуру VARIANT, содержащую сведения, передаваемые обратно из элемента управления CIC на панели задач.
Панели задач, использующие шаблоны панели задач MMC
Для панели задач, предоставляемых MMC, структура VARIANT содержит идентификатор команды для задачи панели задач или кнопки представления списка, которая была отознана.
Поле vt — VT_I4, а поле lVal содержит идентификатор команды для задачи панели задач или кнопки представления списка, которая была ed. Кнопки представления списка применяются только к панели задач представления списка.
Идентификатор команды задачи указывается в элементе nCommandID структуры MMC_TASK , который передается в методЕ IEnumTASK::Next , вызываемом MMC при извлечении сведений для этой задачи во время настройки панели задач.
Кнопка представления списка — это кнопка, указанная в элементе szButtonText структуры MMC_LISTPAD_INFO , которая передается в метод IExtendTaskPad::GetListPadInfo , который MMC вызывает при настройке панели задач представления списка. Идентификатор команды кнопки представления списка указывается в элементе nCommandID MMC_LISTPAD_INFO.
Панели задач, использующие пользовательские HTML-страницы
Для пользовательских панели задач структура VARIANT может содержать любые данные, которые скрипт на настраиваемой HTML-странице хочет передать через метод TaskNotify объекта CIC.
[in] param
Указатель на структуру VARIANT, содержащую сведения, передаваемые обратно из элемента управления CIC на панели задач.
Панели задач, использующие шаблоны панели задач MMC, игнорируют этот параметр. Однако пользовательские панели задач могут использовать его для передачи дополнительного значения в оснастку.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
Оснастка может определить область элемент, которому принадлежит панель задач, с помощью указателя pdo; затем она может идентифицировать задачу по значению VARIANT, возвращаемого в параметре arg. Если панель задач является панелью задач представления списка, оснастка может определить выбранный элемент (или элементы, если поддерживается множественное выделение) в списке результатов с помощью интерфейса IResultData . На основе этих данных оснастка может выполнять соответствующие действия с соответствующим объектом.
Если для панели задач отображается кнопка представления списка, оснастка может определить кнопку для конкретной панели задач по значению VARIANT, возвращенному в параметре arg.
Пользовательская панель задач может передавать любые значения, которые, по ее определению, должны отправляться в параметрах arg и param.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |