DeleteFileA-Funktion (fileapi.h)

Artikel
01/05/2024

Löscht eine vorhandene Datei.

Verwenden Sie zum Ausführen dieses Vorgangs als transaktionierten Vorgang die DeleteFileTransacted-Funktion .

Syntax

BOOL DeleteFileA(
  [in] LPCSTR lpFileName
);

Parameter

[in] lpFileName

Der Name der zu löschenden Datei.

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.

Tipp

Ab Windows 10 Version 1607 können Sie die MAX_PATH-Einschränkung entfernen, ohne "\\?\" vorauszustellen. Weitere Informationen finden Sie im Abschnitt "Maximale Pfadlängenbegrenzung" unter Benennung von Dateien, Pfaden und Namespaces .

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn eine Anwendung versucht, eine Datei zu löschen, die nicht vorhanden ist, schlägt die DeleteFile-Funktion mit ERROR_FILE_NOT_FOUND fehl. Wenn es sich bei der Datei um eine schreibgeschützte Datei handelt, schlägt die Funktion mit ERROR_ACCESS_DENIED fehl.

Die folgende Liste enthält einige Tipps zum Löschen, Entfernen oder Schließen von Dateien:

Um eine schreibgeschützte Datei zu löschen, müssen Sie zuerst das schreibgeschützte Attribut entfernen.
Um eine Datei zu löschen oder umzubenennen, müssen Sie entweder über die Löschberechtigung für die Datei oder über eine untergeordnete Berechtigung im übergeordneten Verzeichnis verfügen.
Um die Dateien in einem Verzeichnis rekursiv zu löschen, verwenden Sie die SHFileOperation-Funktion .
Um ein leeres Verzeichnis zu entfernen, verwenden Sie die RemoveDirectory-Funktion .
Um eine geöffnete Datei zu schließen, verwenden Sie die CloseHandle-Funktion .

Wenn Sie ein Verzeichnis mit allen Zugriffen mit Ausnahme des untergeordneten Löschens und Löschens einrichten und die Zugriffssteuerungslisten (Access Control Lists, ACL) neuer Dateien geerbt werden, können Sie eine Datei erstellen, ohne sie löschen zu können. Dann können Sie jedoch eine Datei erstellen und dann den gesamten Zugriff erhalten, den Sie auf das Handle anfordern, das Ihnen zum Zeitpunkt der Erstellung der Datei zurückgegeben wird.

Wenn Sie zum Zeitpunkt der Erstellung einer Datei die Löschberechtigung anfordern, können Sie die Datei mit diesem Handle löschen oder umbenennen, aber nicht mit einem anderen Handle. Weitere Informationen finden Sie unter Dateisicherheit und Zugriffsrechte.

Die DeleteFile-Funktion schlägt fehl, wenn eine Anwendung versucht, eine Datei zu löschen, die andere Handles für normale E/A-Vorgänge oder als Speicherzuordnungsdatei geöffnet hat (FILE_SHARE_DELETE beim Öffnen anderer Handles angegeben werden muss).

Die DeleteFile-Funktion markiert eine Datei zum Löschen beim Schließen. Daher erfolgt das Löschen der Datei erst, wenn das letzte Handle für die Datei geschlossen wurde. Nachfolgende Aufrufe von CreateFile zum Öffnen der Datei schlagen mit ERROR_ACCESS_DENIED fehl.

Die Verwendung von POSIX delete bewirkt, dass die Datei gelöscht wird, während Handles geöffnet bleiben. Nachfolgende Aufrufe von CreateFile zum Öffnen der Datei schlagen mit ERROR_FILE_NOT_FOUND fehl.

Verhalten symbolischer Verknüpfungen:

Wenn der Pfad auf einen symbolischen Link verweist, wird der symbolische Link gelöscht, nicht das Ziel. Um ein Ziel zu löschen, müssen Sie CreateFile aufrufen und FILE_FLAG_DELETE_ON_CLOSE angeben.

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

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Beispiele

Ein Beispiel finden Sie unter Sperren und Entsperren von Bytebereichen in Dateien.

Hinweis

Der Fileapi.h-Header definiert DeleteFile als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll