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

類型： 無效**

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

返回值

類型：HRESULT

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

備註

此函式通常會用於 IShellFolder：：GetUIObjectOf 的實作中。 GetUIObjectOf 會建立內容功能表，以合併 DEFCONTEXTMENU 結構所指定的 IContextMenu 處理常式，並可以選擇性地提供預設內容功能表動詞實作，例如 open、explore、delete 和 copy。

此函式的作業是由 DEFCONTEXTMENU 結構中指定的輸入所控制。APICDefFolderMenu_Create2 是建構預設內容功能表實作的另一種方式。 它比 SHCreateDefaultContextMenu 表現力較差，但它存在於 Windows Vista 之前的平臺中。

需求