Funzione GetTempPathA (fileapi.h)

  • Articolo

Recupera il percorso della directory designata per i file temporanei.

Sintassi

DWORD GetTempPathA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

Parametri

[in] nBufferLength

Dimensioni del buffer stringa identificato da lpBuffer, in TCHAR.

[out] lpBuffer

Puntatore a un buffer stringa che riceve la stringa con terminazione Null che specifica il percorso del file temporaneo. La stringa restituita termina con una barra rovesciata, ad esempio "C:\TEMP\".

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la lunghezza, in TCHARs, della stringa copiata in lpBuffer, senza includere il carattere Null di terminazione. Se il valore restituito è maggiore di nBufferLength, il valore restituito è la lunghezza, in TCHARs, del buffer necessario per contenere il percorso.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Il valore restituito massimo possibile è MAX_PATH+1 (261).

Commenti

Nota

Le app devono chiamare GetTempPath2 anziché GetTempPath.

La funzione GetTempPath verifica l'esistenza di variabili di ambiente nell'ordine seguente e usa il primo percorso trovato:

  1. Il percorso specificato dalla variabile di ambiente TMP.
  2. Il percorso specificato dalla variabile di ambiente TEMP.
  3. Il percorso specificato dalla variabile di ambiente USERPROFILE.
  4. La directory Windows.
Si noti che la funzione non verifica l'esistenza del percorso, né verifica se il processo corrente dispone di diritti di accesso per il percorso. La funzione GetTempPath restituisce la stringa formattata correttamente che specifica il percorso completo in base all'ordine di ricerca della variabile di ambiente come specificato in precedenza. L'applicazione deve verificare l'esistenza del percorso e i diritti di accesso adeguati per il percorso prima di qualsiasi uso per le operazioni di I/O dei file.

Comportamento del collegamento simbolico: se il percorso punta a un collegamento simbolico, il nome del percorso temporaneo mantiene tutti i collegamenti simbolici.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 Sì
Failover trasparente SMB 3.0 (TFO) Sì
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO) Sì
File system del volume condiviso cluster (CsvFS) Sì
Resilient File System (ReFS) Sì
 

Esempi

Per un esempio, vedere Creazione e uso di un file temporaneo.

Nota

L'intestazione fileapi.h definisce GetTempPath come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione fileapi.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Funzioni di gestione file

GetTempFileName

Collegamenti simbolici