Fonction SHSimpleIDListFromPath (shobjidl_core.h)

Article
03/02/2024

Action déconseillée. Retourne un pointeur vers une structure ITEMIDLIST lors de la transmission d’un chemin d’accès.

Syntaxe

PIDLIST_ABSOLUTE SHSimpleIDListFromPath(
  [in] PCWSTR pszPath
);

Paramètres

[in] pszPath

Type : PCWSTR

Pointeur vers une chaîne terminée par null qui contient le chemin d’accès à convertir en PIDL.

Valeur retournée

Type : PIDLIST_ABSOLUTE

Retourne un pointeur vers une structure ITEMIDLIST en cas de réussite, ou NULL dans le cas contraire.

Remarques

Avant Windows 7, cette fonction était déclarée dans Shlobj.h. Dans Windows 7 et versions ultérieures, il est déclaré dans Shobjidl.h.

Note Cette fonction est disponible via Windows 7 et Windows Server 2003. Il est possible qu’il ne soit pas présent dans les versions futures de Windows.

Une alternative à cette fonction est la suivante :

Appelez SHGetDesktopFolder pour obtenir IShellFolder pour le dossier de bureau.
Obtenez le contexte de liaison du IShellFolder (IBindCtx).
Appelez IShellFolder ::P arseDisplayName avec le IBindCtx et le chemin.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [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)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.00 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240)

Partager via