SHCreateDefaultContextMenu 函式 (shlobj_core.h)
建立 物件,此物件表示Shell的預設操作功能表實作。
語法
SHSTDAPI SHCreateDefaultContextMenu(
[in] const DEFCONTEXTMENU *pdcm,
REFIID riid,
[out] void **ppv
);
參數
[in] pdcm
類型: const DEFCONTEXTMENU*
常數 DEFCONTEXTMENU 結構的指標。
riid
類型: REFIID
要基底物件之介面的介面標識元參考。 這通常是 IContextMenu、IContextMenu2 或 IContextMenu3 的 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 版) |