Fonction SHCreateDefaultContextMenu (shlobj_core.h)

Article
08/08/2024

Crée un objet qui représente l’implémentation de menu contextuel par défaut de l’interpréteur de commandes.

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 retourne, 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 ouvrir, explorer, supprimer et copier.

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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
DLL	Shell32.dll (version 6.0.6000 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)

Partager via