SHILCreateFromPath, fonction (shlobj_core.h)

[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