GetTempPathA-Funktion (fileapi.h)

Artikel
11/20/2024

Ruft den Pfad des Verzeichnisses ab, das für temporäre Dateien bestimmt ist.

Syntax

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

Parameter

[in] nBufferLength

Die Größe des durch lpBufferidentifizierten Zeichenfolgenpuffers in TCHARs.

[out] lpBuffer

Ein Zeiger auf einen Zeichenfolgenpuffer, der die mit Null beendete Zeichenfolge empfängt, die den temporären Dateipfad angibt. Die zurückgegebene Zeichenfolge endet mit einem umgekehrten Schrägstrich, z. B. "C:\TEMP\".

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Länge in TCHARsder Zeichenfolge, die in lpBuffer-kopiert wurde, nicht einschließlich des endenden NULL-Zeichens. Wenn der Rückgabewert größer als nBufferLengthist, ist der Rückgabewert die Länge in TCHARsdes Puffers, der zum Speichern des Pfads erforderlich ist.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Der maximal mögliche Rückgabewert ist MAX_PATH+1 (261).

Bemerkungen

Anmerkung

Apps sollten GetTempPath2- anstelle von GetTempPath-aufrufen.

Die GetTempPath-Funktion sucht nach dem Vorhandensein von Umgebungsvariablen in der folgenden Reihenfolge und verwendet den ersten gefundenen Pfad:

Der durch die TMP-Umgebungsvariable angegebene Pfad.
Der durch die TEMP-Umgebungsvariable angegebene Pfad.
Der pfad, der von der USERPROFILE-Umgebungsvariable angegeben wird.
Das Windows-Verzeichnis.

Beachten Sie, dass die Funktion nicht überprüft, ob der Pfad vorhanden ist, oder ob der aktuelle Prozess über eine Art von Zugriffsrechten für den Pfad verfügt. Die GetTempPath--Funktion gibt die ordnungsgemäß formatierte Zeichenfolge zurück, die den vollqualifizierten Pfad basierend auf der Suchreihenfolge der Umgebungsvariablen wie zuvor angegeben angibt. Die Anwendung sollte das Vorhandensein des Pfads und angemessene Zugriffsrechte für den Pfad vor jeder Verwendung für Datei-E/A-Vorgänge überprüfen.

Verhalten symbolischer Verknüpfungen – Wenn der Pfad auf eine symbolische Verknüpfung zeigt, behält der Name des temporären Pfads symbolische Verknüpfungen bei.

In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Abgestützt
Server Message Block (SMB) 3.0-Protokoll	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Skalierungsdateifreigaben (SO)	Ja
Freigegebenes Clustervolumedateisystem (CsvFS)	Ja
Resilient File System (ReFS)	Ja

Beispiele

Ein Beispiel finden Sie unter Erstellen und Verwenden einer temporären Datei.

Anmerkung

Der Fileapi.h-Header definiert GetTempPath als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	fileapi.h (include Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

Dateiverwaltungsfunktionen

GetTempFileName-

symbolische Verknüpfungen

Freigeben über