Fonction SHGetPathFromIDListW (shlobj_core.h)
Convertit une liste d’identificateurs d’élément en chemin d’accès du système de fichiers.
Syntaxe
BOOL SHGetPathFromIDListW(
[in] PCIDLIST_ABSOLUTE pidl,
[out] LPWSTR 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
| Condition requise | Valeur |
|---|---|
| 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) |