Función GetTempPath2A (fileapi.h)
Recupera la ruta de acceso del directorio designado para los archivos temporales, en función de los privilegios del proceso de llamada.
Sintaxis
DWORD GetTempPath2A(
[in] DWORD BufferLength,
[out] LPSTR Buffer
);
Parámetros
[in] BufferLength
Tamaño del búfer de cadenas identificado por lpBuffer, en TCHAR.
[out] Buffer
Puntero a un búfer de cadenas que recibe la cadena terminada en NULL que especifica la ruta de acceso del archivo temporal. La cadena devuelta termina con una barra diagonal inversa, por ejemplo, "C:\TEMP\".
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es la longitud, en TCHAR, de la cadena copiada en lpBuffer, sin incluir el carácter nulo de terminación. Si el valor devuelto es mayor que nBufferLength, el valor devuelto es la longitud, en TCHAR, del búfer necesario para contener la ruta de acceso.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
El valor devuelto máximo posible es MAX_PATH+1 (261).
Comentarios
Al llamar a esta función desde un proceso que se ejecuta como SYSTEM, devolverá la ruta de acceso C:\Windows\SystemTemp, que no es accesible para los procesos que no son del sistema. En el caso de los procesos que no son SYSTEM, GetTempPath2 se comportará igual que GetTempPath.
La función GetTempPath2 comprueba la existencia de variables de entorno en el orden siguiente y usa la primera ruta de acceso encontrada:
- Ruta de acceso especificada por la variable de entorno TMP.
- Ruta de acceso especificada por la variable de entorno TEMP.
- Ruta de acceso especificada por la variable de entorno USERPROFILE.
- El directorio de Windows.
Comportamiento de vínculo simbólico: si la ruta de acceso apunta a un vínculo simbólico, el nombre de la ruta de acceso temporal mantiene los vínculos simbólicos.
En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.
Tecnología | Compatible |
---|---|
Protocolo Bloque de mensajes del servidor (SMB) 3.0 | Sí |
Conmutación por error transparente (TFO) de SMB 3.0 | Sí |
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | Sí |
Sistema de archivos de Volumen compartido de clúster (CsvFS) | Sí |
Sistema de archivos resistente a errores (ReFS) | Sí |
Ejemplos
Para obtener un ejemplo, vea Crear y usar un archivo temporal.
Nota
El encabezado fileapi.h define GetTempPath2 como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | compilación 20348 de Windows 10 |
Servidor mínimo compatible | Windows Server Build 20348 |
Encabezado | fileapi.h (incluye Windows.h) |
Library | Kernel32.lib |
Archivo DLL | Kernel32.dll |
Vea también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de