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:  8.140

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