CONTEXTContextMenuCallback::AddExtensionMenuItem メソッド (cluadmex.h)

[アーティクル]
08/22/2023

[このメソッドは、[要件] セクションで指定したオペレーティングシステムで使用できます。このメソッドのサポートは、Windows Server 2008 で削除されました。]

フェールオーバークラスター管理者コンテキストメニューにメニュー項目を追加します。

構文

HRESULT AddExtensionMenuItem(
  [in] BSTR  lpszName,
  [in] BSTR  lpszStatusBarText,
  [in] ULONG nCommandID,
  [in] ULONG nSubmenuCommandID,
  [in] ULONG uFlags
);

パラメーター

[in] lpszName

メニューに追加する項目の名前を含む null で終わる Unicode 文字列へのポインター。 BSTR として宣言されていますが、このパラメーターは LPWSTR として実装されます。

[in] lpszStatusBarText

新しい項目が選択されたときにステータスバーに表示するテキストへのポインター。 BSTR として宣言されていますが、このパラメーターは LPWSTR として実装されます。

[in] nCommandID

メニュー項目が選択されたときに呼び出されるコマンドの識別子。 nCommandID パラメーターを –1 に設定することはできません。

[in] nSubmenuCommandID

サブメニューの識別子。サブメニューはサポートされておらず、 nSubmenuCommandID パラメーターは 0 である必要があります。

[in] uFlags

新しいメニュー項目を記述するフラグのビットマスク。次の値のうち 1 つ以上を設定できます。

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 で終わる Unicode 文字列へのポインターが含まれています。これが既定の解釈です。

戻り値

AddExtensionMenuItem が成功しない場合は、他の HRESULT 値を返すことができます。

リターンコード/値	Description
NOERROR 0	操作に成功しました。
E_INVALIDARG 0x80070057	uFlags パラメーターは、MF_OWNERDRAWまたはMF_POPUPに設定されました。
E_OUTOFMEMORY 0x8007000e	メニュー項目の割り当て中にエラーが発生しました。

注釈

AddExtensionMenuItem メソッドは、コンテキストメニューの上部に項目を追加し、その後に区切り記号を付けます。ユーザーがこのメニュー項目を選択すると、 nCommandID によって識別されるコマンドが nCommandID パラメーターで IWEInvokeCommand::InvokeCommand メソッドに渡されます。

MF_OWNERDRAWフラグとMF_POPUP フラグは、特に uFlags パラメーターではサポートされていないことに注意してください。

フェールオーバークラスター管理者拡張機能は、IWEExtendContextMenu::AddContextMenuItems メソッドから AddExtensionMenuItem を呼び出します。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2003 Enterprise、Windows Server 2003 Datacenter
対象プラットフォーム	Windows
ヘッダー	cluadmex.h

こちらもご覧ください

CONTEXTContextMenuCallback

IWEExtendContextMenu::AddContextMenuItems

IWEInvokeCommand::InvokeCommand

次の方法で共有