System.SysUtils.FileOpen

• Übergeordnet: System.SysUtils

Delphi

function FileOpen(const FileName: string; Mode: LongWord): THandle;

C++

extern DELPHI_PACKAGE Winapi::Windows::THandle __fastcall FileOpen(const System::UnicodeString FileName, System::LongWord Mode);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.SysUtils.pas System.SysUtils.hpp	System.SysUtils	System.SysUtils

Beschreibung

FileOpen öffnet eine bestimmte Datei im angegebenen Zugriffsmodus.

Mit FileOpen können Sie eine Datei öffnen und ihr Datei-Handle ermitteln. Der Parameter Mode legt fest, wie die Datei geöffnet wird. Mode enthält den Öffnungsmodus und (evtl.) den Freigabemodus. Beide Werte werden mit einem logischen ODER verknüpft.

Für Öffnungsmodus-Konstanten müssen Sie einen der folgenden Werte verwenden.

Wert	Bedeutung
fmExclusive	Erstellt die Datei nur automatisch, wenn sie nicht vorhanden ist, anderenfalls schlägt die Funktion fehl.
fmOpenRead	Öffnet die Datei ausschließlich zum Lesen.
fmOpenWrite	Öffnet die Datei ausschließlich zum Schreiben. Beim Schreiben in die Datei wird der aktuelle Inhalt vollständig ersetzt.
fmOpenReadWrite	Öffnet die Datei zum Ändern des aktuellen Inhalts, anstatt diesen zu ersetzen.

Für Freigabemodus-Konstanten müssen Sie einen der folgenden Werte verwenden.

Wert	Bedeutung
fmShareCompat	Andere Anwendungen können auf die Datei entsprechend der FCB-Öffnungsmethode zugreifen.
fmShareExclusive	Andere Anwendungen können die Datei nicht öffnen.
fmShareDenyWrite	Andere Anwendungen können die Datei ausschließlich zum Lesen öffnen.
fmShareDenyRead	Andere Anwendungen können die Datei zum Schreiben, nicht aber zum Lesen öffnen.
fmShareDenyNone	Andere Anwendungen können die Datei ohne Einschränkungen zum Lesen oder Schreiben öffnen.

FileOpen kann Folgendes zurückgeben:

• Einen anderen Wert als INVALID_HANDLE_VALUE, was bedeutet, dass die Funktion erfolgreich war und der Wert das Datei-Handle der geöffneten Datei ist.
• Einen Wert gleich INVALID_HANDLE_VALUE, der anzeigt, dass ein Fehler aufgetreten ist.

Hinweis: Nicht native Delphi-Dateibehandlungsroutinen, wie FileOpen, sollten nicht verwendet werden. Diese Routinen greifen auf Systemroutinen zurück und geben Betriebssystem-Datei-Handle zurück, keine Delphi-Dateivariablen. Dabei handelt es sich um Low-Level-Routinen für den Dateizugriff. Verwenden Sie für normale Dateioperationen stattdessen AssignFile, Rewrite und Reset.

Siehe auch

• FileClose
• FileCreate
• AssignFile
• Rewrite
• Reset
• Unterstützung der Dateiein- und -ausgabe

Codebeispiele

• FileListBox (Delphi)
• FileOpen (C++)
• FileOpen (Delphi)
• FileRead (Delphi)
• FileToGrid (C++)
• FileToGrid (Delphi)
• SysUtilsFileOpen (C++)