GetTempFileName

Deklaration  

Declare Function GetTempFileName Lib "kernel32" _
                 Alias "GetTempFileNameA" ( _
                 ByVal lpszPath As String, _
                 ByVal lpPrefixString As String, _
                 ByVal wUnique As Long, _
                 ByVal lpTempFileName As String) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel GetTempFileName des API-Wikis.

GetTempFileName erzeugt ein temporäres Verzeichnis nach dem Muster pfad/preuuuu.tmp . pfad gibt den im Parameter lpszPath spezifizierten Pfad an, pre die ersten 3 Buchstaben des lpPrefixStrings und uuuu ist der hexadezimale Wert von uUnique oder eine vom System eindeutig erzeugte Nummer. Wenn Windows heruntergefahren wird, werden temporäre Dateien, die mit dieser Funktion erzeugt wurden, nicht automatisch gelöscht.

Parameter
lpszPath	Ein Zeiger auf einen nullterminierten String, der den Pfad enthält, unter dem die funktion den Namen des temporären Verzeichnisses erzeugt.Normalerweise geben Anwendungen einen Punkt [.] oder das Ergebnis von GetTempPath für diesen Parameter an. Wird der Parameter auf Null gesetzt schlägt die Funktion fehl.
lpPrefixString	Ein Zeiger auf einen nullterminierten String, der als Präfix für den Namen der temporären Datei dient.
wUnique	Ein vorzeichenloser Integer-Wert zum Erzeugen des temporären Dateinamens. Wenn dieser Parameter ungleich Null ist, wird er an den temporären Dateinamen angefügt. Ist er Null, verwendet Windows die aktuelle Systemzeit, um eine Nummer zu erzeugen, die dem Dateinnamen angefügt wird.
lpTempFileName	Ein Zeiger auf einen Puffer, der den nulterminierten Namen des temporären Verzeichnissen aufnimmt. Dieser Puffer sollte mindestens die Länge MAX_PATH aufweisen.

Tabelle 1

Rückgabewerte
Num	die Funktion war erfolgreich, es wird der eindeutige numerische Wert, der im Namen der temporären Datei verwendet wird, zurückgegeben.
0	Eslag ein Fehler vor.

Tabelle 2

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreateFile, GetTempPath

Zugehörige Tipps

• Temporäre Datei erstellen [Tipp 0065]