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

Voir aussi

PathMakeUniqueName