Die Community zu .NET und Classic VB.
Menü

GetTempFileName

 von 

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
lpszPathEin 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.
lpPrefixStringEin Zeiger auf einen nullterminierten String, der als Präfix für den Namen der temporären Datei dient.
wUniqueEin 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.
lpTempFileNameEin 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
Numdie Funktion war erfolgreich, es wird der eindeutige numerische Wert, der im Namen der temporären Datei verwendet wird, zurückgegeben.
0Eslag ein Fehler vor.

Tabelle 2


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

Verwandte API-Funktionen
CreateFile, GetTempPath

Zugehörige Tipps