SHCreateDefaultContextMenu 函式 (shlobj_core.h)

建立 物件,此物件表示Shell的預設操作功能表實作。

語法

SHSTDAPI SHCreateDefaultContextMenu(
  [in]  const DEFCONTEXTMENU *pdcm,
        REFIID               riid,
  [out] void                 **ppv
);

參數

[in] pdcm

類型: const DEFCONTEXTMENU*

常數 DEFCONTEXTMENU 結構的指標。

riid

類型: REFIID

要基底物件之介面的介面標識元參考。 這通常是 IContextMenu、IContextMenu2IContextMenu3 的 IID。

[out] ppv

類型: void**

當這個方法傳回時,包含 riid中要求的介面指標。

傳回值

類型: HRESULT

如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

此函式通常用於 IShellFolder::GetUIObjectOf 的實作中。 GetUIObjectOf 會建立操作功能表,合併 DEFCONTEXTMENU 結構所指定的 IContextMenu 處理程式,而且可以選擇性地提供預設操作功能表動詞實作,例如開啟、探索、刪除和複製。

此函式的作業是由 DEFCONTEXTMENU 結構中指定的輸入所控制。APICDefFolderMenu_Create2 是建構預設操作功能表實作的另一種方式。 它比 SHCreateDefaultContextMenu 更不具表達性,但它存在於 Windows Vista 之前的平臺中。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shlobj_core.h (包含 Shlobj.h)
Dll Shell32.dll (6.0.6000 版或更新版本)
API 集合 ext-ms-win-shell32-l1-2-2 (於 Windows 10 10.0.14393 版)