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