SHCreateDefaultContextMenu, fonction (shlobj_core.h)

Crée un objet qui représente l’implémentation du menu contextuel par défaut de Shell.

Syntaxe

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

Paramètres

[in] pdcm

Type : const DEFCONTEXTMENU*

Pointeur vers une structure DEFCONTEXTMENU constante.

riid

Type : REFIID

Référence à l’ID d’interface de l’interface sur laquelle baser l’objet. Il s’agit généralement de l’IID de IContextMenu, IContextMenu2 ou IContextMenu3.

[out] ppv

Type : void**

Lorsque cette méthode est retournée, contient le pointeur d’interface demandé dans riid.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

Cette fonction est généralement utilisée dans l’implémentation de IShellFolder ::GetUIObjectOf. GetUIObjectOf crée un menu contextuel qui fusionne les gestionnaires IContextMenu spécifiés par la structure DEFCONTEXTMENU et peut éventuellement fournir des implémentations de verbes de menu contextuel par défaut telles que l’ouverture, l’exploration, la suppression et la copie.

L’opération de cette fonction est contrôlée par l’entrée spécifiée dans la structure DEFCONTEXTMENU . L’API CDefFolderMenu_Create2 est une autre façon de construire l’implémentation du menu contextuel par défaut. Il est moins expressif que SHCreateDefaultContextMenu , mais il existe dans les plateformes antérieures à Windows Vista.

Spécifications