SHCreateDefaultContextMenu 関数 (shlobj_core.h)

シェルの既定のコンテキスト メニューの実装を表すオブジェクトを作成します。

構文

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

パラメーター

[in] pdcm

型: const DEFCONTEXTMENU*

定数 DEFCONTEXTMENU 構造体へのポインター。

riid

型: REFIID

オブジェクトの基となるインターフェイスのインターフェイス ID への参照。 これは通常、IContextMenu、IContextMenu2、または IContextMenu3 の IID です。

[out] ppv

型: void**

このメソッドが戻るときに、 riid で要求されたインターフェイス ポインターを格納します。

戻り値

型: HRESULT

この関数が成功すると、S_OKが返 されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

注釈

この関数は通常、 IShellFolder::GetUIObjectOf の実装で使用されます。 GetUIObjectOf は、DEFCONTEXTMENU 構造体で指定された IContextMenu ハンドラーをマージするコンテキスト メニューを作成し、必要に応じて、開く、探索、削除、コピーなどの既定のコンテキスト メニュー動詞の実装を提供できます。

この関数の操作は、 DEFCONTEXTMENU 構造体で指定された入力によって制御されます。APICDefFolderMenu_Create2 は、既定のコンテキスト メニューの実装を構築するもう 1 つの方法です。 SHCreateDefaultContextMenu よりも表現力は低いですが、Windows Vista より前のプラットフォームに存在します。

Requirements