Fonction PathYetAnotherMakeUniqueName (shlobj_core.h)
Crée un nom de fichier unique basé sur un nom de fichier existant.
Syntaxe
BOOL PathYetAnotherMakeUniqueName(
[out] PWSTR pszUniqueName,
[in] PCWSTR pszPath,
[in, optional] PCWSTR pszShort,
[in, optional] PCWSTR pszFileSpec
);
Paramètres
[out] pszUniqueName
Type : PWSTR
Mémoire tampon de chaîne qui reçoit une chaîne Unicode terminée par null qui contient le chemin complet du nom de fichier unique. Cette mémoire tampon doit comporter au moins MAX_PATH caractères pour éviter de provoquer un dépassement de mémoire tampon.
[in] pszPath
Type : PCWSTR
Chaîne Unicode terminée par un caractère Null qui contient le chemin complet du dossier qui contiendra le nouveau fichier. Si pszShort est défini sur NULL, cette chaîne doit contenir un chemin de destination complet, se terminant par le nom de fichier long sur lequel le nouveau nom de fichier sera base.
[in, optional] pszShort
Type : PCWSTR
Chaîne Unicode terminée par null qui contient le nom de fichier court sur lequel le nom unique sera basé. Définissez cette valeur sur NULL pour créer un nom basé sur le nom de fichier long.
[in, optional] pszFileSpec
Type : PCWSTR
Chaîne Unicode terminée par null qui contient le nom de fichier long sur lequel le nom unique sera basé.
Valeur retournée
Type : BOOL
Retourne TRUE si un nom unique a été créé avec succès ; sinon , FALSE.
Remarques
Si le chemin généré dépasse MAX_PATH caractères, cette fonction peut retourner une chaîne tronquée dans PathYetAnotherMakeUniqueName. Dans ce cas, la fonction retourne FALSE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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) |
| Ensemble d’API | ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240) |