Fonction PathMakeUniqueName (shlobj_core.h)
Crée un nom de chemin d’accès unique à partir d’un modèle.
Syntaxe
BOOL PathMakeUniqueName(
[out] PWSTR pszUniqueName,
UINT cchMax,
[in] PCWSTR pszTemplate,
[in, optional] PCWSTR pszLongPlate,
[in, optional] PCWSTR pszDir
);
Paramètres
[out] pszUniqueName
Type : PWSTR
Mémoire tampon qui reçoit une chaîne Unicode terminée par null qui contient le nom de chemin d’accès unique. Il doit contenir au moins MAX_PATH caractères.
cchMax
Type : UINT
Nombre de caractères dans la mémoire tampon pointée vers pszUniqueName.
[in] pszTemplate
Type : PCWSTR
Chaîne Unicode terminée par null qui contient un modèle utilisé pour construire le nom unique. Ce modèle est utilisé pour les lecteurs qui nécessitent des noms de fichiers au format 8.3. Cette chaîne ne doit pas contenir plus de MAX_PATH caractères, y compris le caractère null de fin.
[in, optional] pszLongPlate
Type : PCWSTR
Chaîne Unicode terminée par null qui contient un modèle utilisé pour construire le nom unique. Ce modèle est utilisé pour les lecteurs qui prennent en charge les noms de fichiers longs. Cette chaîne ne doit pas contenir plus de MAX_PATH caractères, y compris le caractère null de fin.
[in, optional] pszDir
Type : PCWSTR
Chaîne terminée par null qui contient le répertoire dans lequel réside le nouveau fichier. Cette chaîne ne doit pas contenir plus de MAX_PATH caractères, y compris le caractère null de fin.
Valeur retournée
Type : BOOL
Retourne TRUE en cas de réussite ; sinon, FALSE.
Remarques
Cette fonction génère un nouveau nom de fichier unique basé sur les modèles spécifiés par pszTemplate, pour les lecteurs qui nécessitent le format 8.3, et pszLongPlate pour les lecteurs qui prennent en charge les noms de fichiers longs. Par exemple, si vous spécifiez « Mon nouveau nom de fichier » pour pszLongPlate, PathMakeUniqueName renvoie des noms tels que « Mon nouveau nom de fichier (1) », « Mon nouveau nom de fichier (2) », etc.
Configuration requise
Client minimal pris en charge | Windows 2000 Professionnel [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) |
Bibliothèque | Shell32.lib |
DLL | Shell32.dll (version 5.0 ou ultérieure) |