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

Indique à un objet de dossier Shell de s’initialiser en fonction des informations passées.

Syntaxe

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Paramètres

pidl

Type : LPCITEMIDLIST

Adresse de la structure ITEMIDLIST (liste d’identificateurs d’élément) qui spécifie l’emplacement absolu du 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

Tous les objets qui implémentent l’interface IShellFolder pour une utilisation dans l’espace de noms de l’interpréteur de commandes doivent implémenter cette méthode. Lorsque l’emplacement d’un dossier dans l’espace de noms n’est pas une considération pertinente, cette méthode peut simplement retourner S_OK. Lorsque l’emplacement est pertinent pour le dossier, vous devez stocker l’IDLIST complet passé pour référence ultérieurement.

Par exemple, si l’implémentation du dossier doit construire un pointeur qualifié complet vers une liste d’identificateurs d’élément (PIDL) vers les éléments qu’elle contient, le PIDL passé à cette méthode doit être utilisé pour construire les PIDL complets.

Configuration requise

Condition requise	Valeur
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 (incluez Shobjidl.h)
DLL	Shell32.dll (version 4.0 ou ultérieure)