Función PathYetAnotherMakeUniqueName (shlobj_core.h)
Crea un nombre de archivo único basado en un nombre de archivo existente.
Sintaxis
BOOL PathYetAnotherMakeUniqueName(
[out] PWSTR pszUniqueName,
[in] PCWSTR pszPath,
[in, optional] PCWSTR pszShort,
[in, optional] PCWSTR pszFileSpec
);
Parámetros
[out] pszUniqueName
Tipo: PWSTR
Un búfer de cadena que recibe una cadena Unicode terminada en null que contiene la ruta de acceso completa del nombre de archivo único. Este búfer debe tener al menos MAX_PATH caracteres para evitar que se supere un búfer.
[in] pszPath
Tipo: PCWSTR
Cadena Unicode terminada en null que contiene la ruta de acceso completa de la carpeta que contendrá el nuevo archivo. Si pszShort se establece en NULL, esta cadena debe contener una ruta de acceso de destino completa, finalizando con el nombre de archivo largo en el que se basará el nuevo nombre de archivo.
[in, optional] pszShort
Tipo: PCWSTR
Cadena Unicode terminada en null que contiene el nombre de archivo corto en el que se basará el nombre único. Establezca este valor en NULL para crear un nombre basado en el nombre de archivo largo.
[in, optional] pszFileSpec
Tipo: PCWSTR
Cadena Unicode terminada en null que contiene el nombre de archivo largo en el que se basará el nombre único.
Valor devuelto
Tipo: BOOL
Devuelve TRUE si se creó correctamente un nombre único; en caso contrario , FALSE.
Comentarios
Si la ruta de acceso generada supera MAX_PATH caracteres, esta función puede devolver una cadena truncada en PathYetAnotherMakeUniqueName. En ese caso, la función devuelve FALSE.
Requisitos
| Requisito | Value |
|---|---|
| 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) |
| Conjunto de API | ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240) |