Funzione GetTempPathA (fileapi.h)

Articolo
11/20/2024

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 di 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

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

Osservazioni

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:

Percorso specificato dalla variabile di ambiente TMP.
Percorso specificato dalla variabile di ambiente TEMP.
Percorso specificato dalla variabile di ambiente USERPROFILE.
Directory di Windows.

Si noti che la funzione non verifica che il percorso esista, 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 delle variabili di ambiente come specificato in precedenza. L'applicazione deve verificare l'esistenza del percorso e i diritti di accesso adeguati al percorso prima di qualsiasi utilizzo 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	Sostenuto
Protocollo SMB (Server Message Block) 3.0	Sì
SMB 3.0 Transparent Failover (TFO)	Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	Sì
Cluster Shared Volume File System (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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	fileapi.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

funzioni di gestione file

GetTempFileName

collegamenti simbolici

Condividi tramite