IPersistFolder3 ::InitializeEx, méthode (shobjidl_core.h)

Article
2023-08-26

Initialise un dossier et spécifie son emplacement dans l’espace de noms. Si le dossier est un raccourci, cette méthode spécifie également l’emplacement du dossier cible.

Syntaxe

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

Paramètres

[in] pbc

Type : IBindCtx*

Pointeur vers un objet IBindCtx qui fournit le contexte de liaison. Ce paramètre peut être NULL.

[in] pidlRoot

Type : LPCITEMIDLIST

Pointeur vers un PIDL complet qui spécifie l’emplacement absolu d’un dossier ou d’un raccourci de dossier. L’application appelante est responsable de l’allocation et de la libération de ce PIDL.

[in] ppfti

Type : const PERSIST_FOLDER_TARGET_INFO*

Pointeur vers une structure de PERSIST_FOLDER_TARGET_INFO qui spécifie l’emplacement du dossier cible et ses attributs.

Si ppfti pointe vers une structure valide, pidlRoot représente un raccourci de dossier.

Si ppfti a la valeur NULL, pidlRoot représente un dossier normal. Dans ce cas, InitializeEx doit se comporter comme si Initialize avait été appelé.

Valeur retournée

Type : HRESULT

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

Remarques

Cette fonction est une version étendue de IPersistFolder ::Initialize. Il permet à l’interpréteur de commandes d’initialiser les raccourcis de dossier ainsi que les dossiers normaux.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel avec SP3, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via