Rubrik: Dateisystem | 13.07.01 |
MoveFile-Funktion Diese Funktion benennt eine Datei um oder verschiebt sie an einen anderen Ort (Laufwerk/Ordner). | ||
Betriebssystem: Win95, Win98, WinNT 3.1, Win2000, WinME | Views: 16.638 |
Deklaration:
Declare Function MoveFile Lib "kernel32.dll" _ Alias "MoveFileA" ( _ ByVal lpExistingFileName As String, _ ByVal lpNewFileName As String) As Long
Beschreibung:
Diese Funktion benennt eine Datei um oder verschiebt sie an einen anderen Ort (Laufwerk/Ordner).
Parameter:
lpExistingFileName | Erwartetet den vollständigen Dateinamen (inkl. Pfadangabe) der Datei, die umbenannt oder verschoben werden soll. |
lpNewFileName | Der neue Name der Datei oder des Verzeichnisses, wobei ein solcher Name noch nicht existieren darf. Handelt es sich lpExistingFileName um einen Ordner, so kann dieser nicht auf ein anderes Dateisystem oder Laufwerk verschoben werden! |
Rückgabewert:
War der Funktionsaufruf erfolgreich, so ist der Rückgabewert "ungleich 0", andernfalls wird "0" zurückgegeben.
Beispiel:
Private Declare Function MoveFile Lib "kernel32.dll" Alias "MoveFileA" (ByVal lpExistingFileName As String, ByVal lpNewFileName As String) As Long
Private Sub Command1_Click() Dim Retval As Long ' Datei umbenennen Retval = MoveFile("C:\Autoexec.bat", "C:\Autoexec.666") If Retval = 0 Then MsgBox "Verschieben oder Umbenennen fehlgeschlagen", vbInformation, "Fehler" Exit Sub Else MsgBox "Die Datei wurde erfolgreich umbenannt, das Orginal wird nun " & _ "wieder hergestellt.", vbInformation, "Umbenennen" End If ' Rückgängig machen Retval = MoveFile("C:\Autoexec.666", "C:\Autoexec.bat") If Retval = 0 Then MsgBox "Das Original konnte nicht wiederhergestellt werden.", vbCritical, "Fehler" End If End Sub