IWCContextMenuCallback：：AddExtensionMenuItem 方法 (cluadmex.h)

發行項
02/26/2024

[這個方法可用於需求一節中指定的操作系統。 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 參數必須是零。

[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 終止 Unicode 字串的指標。這是預設解譯。

傳回值

如果 AddExtensionMenuItem 不成功，它可以傳回其他 HRESULT 值。

傳回碼/值	Description
NOERROR 0	作業成功。
E_INVALIDARG 0x80070057	uFlags 參數已設定為 MF_OWNERDRAW 或 MF_POPUP。
E_OUTOFMEMORY 0x8007000e	配置功能表項時發生錯誤。

備註

AddExtensionMenuItem 方法會在操作功能表頂端新增專案，後面接著分隔符。當用戶選取此功能表項時， nCommandID 所識別的命令會在 nCommandID 參數中傳遞至 IWEInvokeCommand：：InvokeCommand 方法。

請注意，uFlags 參數不支援MF_OWNERDRAW和MF_POPUP旗標。

故障轉移叢集管理員擴充功能會從其 IWEExtendContextMenu：：AddContextMenuItems 方法呼叫 AddExtensionMenuItem。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 Enterprise、Windows Server 2003 Datacenter
目標平台	Windows
標頭	cluadmex.h

另請參閱

IWCContextMenuCallback

IWEExtendContextMenu：：AddContextMenuItems

IWEInvokeCommand：：InvokeCommand

共用方式為