Метод IWCContextMenuCallback::AddExtensionMenuItem (cluadmex.h)
[Этот метод доступен для использования в операционных системах, указанных в разделе Требования. Поддержка этого метода была удалена в Windows Server 2008.]
Добавляет пункт меню в контекстное меню администратора отказоустойчивого кластера .
Синтаксис
HRESULT AddExtensionMenuItem(
[in] BSTR lpszName,
[in] BSTR lpszStatusBarText,
[in] ULONG nCommandID,
[in] ULONG nSubmenuCommandID,
[in] ULONG uFlags
);
Параметры
[in] lpszName
Указатель на строку Юникода с пустым завершением, содержащую имя элемента, добавляемого в меню. Хотя этот параметр объявлен как BSTR, он реализуется как LPWSTR.
[in] lpszStatusBarText
Указатель на текст, отображаемый в строке состояния при выборе нового элемента. Хотя этот параметр объявлен как BSTR, он реализуется как LPWSTR.
[in] nCommandID
Идентификатор команды, вызываемой при выборе пункта меню. Параметр nCommandID не должен иметь значение –1.
[in] nSubmenuCommandID
Идентификатор подменю. Подменю не поддерживаются, и параметр nSubmenuCommandID должен быть равен нулю.
[in] uFlags
Битовая маска флагов, описывающая новый пункт меню. Можно задать одно или несколько следующих значений.
MF_CHECKED (8)
Действует как переключатель с MF_UNCHECKED, чтобы поместить метку проверка по умолчанию рядом с элементом.
MF_UNCHECKED (0)
Действует как переключатель с MF_CHECKED для удаления проверка метки, размещенной рядом с элементом.
MF_DISABLED (2)
Отключает элемент меню, чтобы его нельзя было выбрать, но не затемнить.
MF_ENABLED (0)
Включает элемент меню, чтобы его можно было выбрать, и восстанавливает его из неактивного состояния, если элемент был ранее неактивен.
MF_GRAYED (1)
Отключает элемент меню, чтобы его нельзя было выбрать, и уменьшает его.
MF_MENUBARBREAK (32 (0x20))
Places элемент в новом столбце. Новый столбец отделяется от старого вертикальной разделительной линией.
MF_MENUBREAK (64 (0x40))
Places элемент в новом столбце. Между столбцами не проводится разделительная линия.
MF_SEPARATOR (2048 (0x800))
Рисует горизонтальную разделительную линию. Эта строка не может быть затемнена, отключена или выделена. Параметры lpszName и lpszStatusBarText игнорируются.
MF_STRING (0)
Указывает, что элемент меню является строкой символов. Параметр lpszName содержит указатель на строку Юникода, завершаемую null. Это интерпретация по умолчанию.
Возвращаемое значение
Если метод AddExtensionMenuItem не выполнен успешно, он может вернуть другие значения HRESULT .
| Возвращаемый код/значение | Описание |
|---|---|
|
Операция выполнена успешно. |
|
Параметру uFlags присвоено значение MF_OWNERDRAW или MF_POPUP. |
|
Произошла ошибка при выделении пункта меню. |
Комментарии
Метод AddExtensionMenuItem добавляет элементы в верхней части контекстного меню и следует за ними с помощью разделителя. Команда, определяемая nCommandID , передается в параметре nCommandID методу IWEInvokeCommand::InvokeCommand, когда пользователь выбирает этот пункт меню.
Обратите внимание, что флаги MF_OWNERDRAW и MF_POPUP не поддерживаются специально для параметра uFlags .
Расширения администратора отказоустойчивого кластера вызывают AddExtensionMenuItem из метода IWEExtendContextMenu::AddContextMenuItems.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 Корпоративная, Windows Server 2003 Datacenter |
| Целевая платформа | Windows |
| Header | cluadmex.h |