IShellExtInit::Initialize, méthode (shobjidl_core.h)

  • Article

Initialise une extension de feuille de propriétés, une extension de menu contextuel ou un gestionnaire de glisser-déplacer.

Syntaxe

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

Paramètres

[in] pidlFolder

Type : PCIDLIST_ABSOLUTE

Pointeur vers une structure ITEMIDLIST qui identifie un dossier de manière unique. Pour les extensions de feuille de propriétés, ce paramètre est NULL. Pour les extensions de menu contextuel, il s’agit de la liste d’identificateurs d’élément du dossier qui contient l’élément dont le menu contextuel est affiché. Pour les extensions de menu glisser-déplacer non par défaut, ce paramètre spécifie le dossier cible.

[in] pdtobj

Type : IDataObject*

Pointeur vers un objet d’interface IDataObject qui peut être utilisé pour récupérer les objets en cours d’action.

[in] hkeyProgID

Type : HKEY

Clé de Registre pour le type d’objet de fichier ou de dossier.

Valeur retournée

Type : HRESULT

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

Remarques

La signification de certains paramètres dépend du type d’extension. Pour les gestionnaires de glisser-déplacer, le paramètre pidlFolder spécifie le dossier de destination (la cible de suppression), le paramètre pdtobj identifie les éléments supprimés et le paramètre hkeyProgID spécifie le type de fichier du dossier de destination.

Pour les extensions de menu contextuel, pdtobj identifie les objets de fichier sélectionnés, hkeyProgID identifie le type de fichier de l’objet avec le focus et pidlFolder a la valeur NULL (pour les objets fichier) ou spécifie le dossier pour lequel le menu contextuel est demandé (pour les menus contextuels en arrière-plan du dossier).

Pour les extensions de feuille de propriétés, pidlFolder a la valeur NULL, pdtobj identifie les objets de fichier sélectionnés et hkeyProgID spécifie le type de fichier de l’objet fichier qui a le focus.

Notes aux implémenteurs

Il s’agit de la première méthode appelée par l’interpréteur de commandes après avoir créé un instance d’une extension de feuille de propriétés, d’une extension de menu contextuel ou d’un gestionnaire de glisser-déplacer.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (inclure Shobjidl.h)
DLL Shell32.dll (version 4.0 ou ultérieure)