Partager via

SHILCreateFromPath, fonction (shlobj_core.h)

  • Article

[SHILCreateFromPath est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Les applications doivent utiliser SHParseDisplayName à la place]

Crée un pointeur vers une liste d’identificateur d’élément (PIDL) à partir d’un chemin d’accès.

Syntaxe

SHSTDAPI SHILCreateFromPath(
  [in]                PCWSTR           pszPath,
  [out]               PIDLIST_ABSOLUTE *ppidl,
  [in, out, optional] DWORD            *rgfInOut
);

Paramètres

[in] pszPath

Type : PCWSTR

Pointeur vers une chaîne terminée par null de longueur maximale MAX_PATH contenant le chemin à convertir.

[out] ppidl

Type : PIDLIST_ABSOLUTE*

Chemin d’accès dans pszPath exprimé en tant que PIDL.

[in, out, optional] rgfInOut

Type : DWORD*

Pointeur vers une valeur DWORD qui, lors de l’entrée, indique tous les attributs du dossier nommé dans pszPath que l’application appelante souhaite récupérer avec le PIDL. À la sortie, cette valeur contient les attributs demandés. Pour obtenir la liste des indicateurs d’attribut possibles pour ce paramètre, consultez IShellFolder ::GetAttributesOf.

Valeur retournée

Type : HRESULT

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

Spécifications

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