Compartir a través de

Función PathMakeUniqueName (shlobj_core.h)

  • Artículo

Crea un nombre de ruta de acceso único a partir de una plantilla.

Sintaxis

BOOL PathMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
                 UINT   cchMax,
  [in]           PCWSTR pszTemplate,
  [in, optional] PCWSTR pszLongPlate,
  [in, optional] PCWSTR pszDir
);

Parámetros

[out] pszUniqueName

Tipo: PWSTR

Búfer que recibe una cadena Unicode terminada en null que contiene el nombre de ruta de acceso único. Debe tener al menos MAX_PATH caracteres de longitud.

cchMax

Tipo: UINT

Número de caracteres del búfer al que apunta pszUniqueName.

[in] pszTemplate

Tipo: PCWSTR

Cadena Unicode terminada en null que contiene una plantilla que se usa para construir el nombre único. Esta plantilla se usa para unidades que requieren nombres de archivo con el formato 8.3. Esta cadena no debe tener más de MAX_PATH caracteres de longitud, incluido el carácter nulo de terminación.

[in, optional] pszLongPlate

Tipo: PCWSTR

Cadena Unicode terminada en null que contiene una plantilla que se usa para construir el nombre único. Esta plantilla se usa para unidades que admiten nombres de archivo largos. Esta cadena no debe tener más de MAX_PATH caracteres de longitud, incluido el carácter nulo de terminación.

[in, optional] pszDir

Tipo: PCWSTR

Cadena terminada en null que contiene el directorio en el que reside el nuevo archivo. Esta cadena no debe tener más de MAX_PATH caracteres de longitud, incluido el carácter nulo de terminación.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si se ejecuta correctamente; de lo contrario, FALSE.

Comentarios

Esta función genera un nuevo nombre de archivo único basado en las plantillas especificadas por pszTemplate, para las unidades que requieren el formato 8.3 y pszLongPlate para las unidades que admiten nombres de archivo largos. Por ejemplo, si especifica "Mi nuevo nombre de archivo" para pszLongPlate, PathMakeUniqueName devuelve nombres como "Mi nuevo nombre de archivo (1)", "Mi nuevo nombre de archivo (2)", etc.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)