SHGetPathFromIDListW, fonction (shlobj_core.h)
Convertit une liste d’identificateurs d’élément en chemin d’accès au 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 (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 au moins MAX_PATH caractères de taille.
Valeur de retour
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.
Note
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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | shlobj_core.h (include 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) |