MoveFile-Funktion (winbase.h)

Verschiebt eine vorhandene Datei oder ein Verzeichnis, einschließlich der untergeordneten Elemente.

Um anzugeben, wie die Datei verschoben werden soll, verwenden Sie die MoveFileEx - oder MoveFileWithProgress-Funktion .

Um diesen Vorgang als transaktionierten Vorgang auszuführen, verwenden Sie die MoveFileTransacted-Funktion .

Syntax

BOOL MoveFile(
  [in] LPCTSTR lpExistingFileName,
  [in] LPCTSTR lpNewFileName
);

Parameter

[in] lpExistingFileName

Der aktuelle Name der Datei oder des Verzeichnisses auf dem lokalen Computer.

Standardmäßig ist der Name auf MAX_PATH Zeichen beschränkt. Um dieses Limit auf 32.767 breite Zeichen zu erweitern, müssen Sie dem Pfad "\\?\" voranstellen. Weitere Informationen finden Sie unter Benennen von Dateien, Pfaden und Namespaces.

[in] lpNewFileName

Der neue Name für die Datei oder das Verzeichnis. Der neue Name darf noch nicht vorhanden sein. Eine neue Datei kann sich auf einem anderen Dateisystem oder Laufwerk befinden. Ein neues Verzeichnis muss sich auf demselben Laufwerk befinden.

Standardmäßig ist der Name auf MAX_PATH Zeichen beschränkt. Um dieses Limit auf 32.767 breite Zeichen zu erweitern, müssen Sie dem Pfad "\\?\" voranstellen. Weitere Informationen finden Sie unter Benennen von Dateien, Pfaden und Namespaces.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Bemerkungen

Mit der MoveFile-Funktion wird entweder eine Datei oder ein Verzeichnis (einschließlich der untergeordneten Elemente) entweder im selben Verzeichnis oder zwischen Verzeichnissen verschoben (umbenannt). Die einzige Einschränkung besteht darin, dass die MoveFile-Funktion bei Verzeichnisverschiebungen fehlschlägt, wenn sich das Ziel auf einem anderen Volume befindet.

Wenn eine Datei auf Volumes verschoben wird, verschob MoveFile den Sicherheitsdeskriptor nicht mit der Datei. Der Datei wird der Standardsicherheitsdeskriptor im Zielverzeichnis zugewiesen.

Die MoveFile-Funktion koordiniert ihren Vorgang mit dem Linkverfolgungsdienst, sodass Linkquellen beim Verschieben nachverfolgt werden können.

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

SMB 3.0 unterstützt keine Umbenennung alternativer Datenströme auf Dateifreigaben mit kontinuierlicher Verfügbarkeitsfunktion.

Anforderungen

Siehe auch

CopyFile

Dateiverwaltungsfunktionen

MoveFileEx

MoveFileTransacted

MoveFileWithProgress