Fonction SHGetPathFromIDListA (shlobj_core.h)

  • Article

Convertit une liste d’identificateurs d’élément en chemin d’accès du système de fichiers.

Syntaxe

BOOL SHGetPathFromIDListA(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPSTR             pszPath
);

Paramètres

[in] pidl

Type : PCIDLIST_ABSOLUTE

Adresse d’une liste d’identificateurs d’élément qui spécifie un emplacement de fichier ou de répertoire par rapport à la racine de l’espace de noms (le bureau).

[out] pszPath

Type : LPTSTR

Adresse d’une mémoire tampon pour recevoir le chemin du système de fichiers. Cette mémoire tampon doit être d’au moins MAX_PATH caractères.

Valeur retournée

Type : BOOL

Retourne TRUE en cas de réussite ; sinon, FALSE.

Remarques

Si l’emplacement spécifié par le paramètre pidl ne fait pas partie du système de fichiers, cette fonction échoue.

Si le paramètre pidl spécifie un raccourci, le pszPath contient le chemin d’accès au raccourci, et non à la cible du raccourci.

Notes

L’en-tête shlobj_core.h définit SHGetPathFromIDList comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

   
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 shlobj_core.h (inclure Shlobj.h, Shlobj_core.h)
Bibliothèque Shell32.lib
DLL Shell32.dll (version 4.0 ou ultérieure)
Ensemble d’API ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

SHGetPathFromIDListEx

SHParseDisplayName