System.SysUtils.FileOpen
Delphi
function FileOpen(const FileName: string; Mode: LongWord): THandle;
C++
extern DELPHI_PACKAGE NativeUInt __fastcall FileOpen(const System::UnicodeString FileName, unsigned Mode);
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Beschreibung
Öffnet eine angegebene Datei im festgelegten Zugriffsmodus.
Mit FileOpen können Sie eine Datei öffnen und ihr Datei-Handle ermitteln. Der Zugriffsmodus ergibt sich durch eine ODER-Verknüpfung einer fmOpen-Konstante mit einer der fmShare-Konstanten (siehe File, Öffnungsmodus-Konstanten). Wenn der Rückgabewert nicht INVALID_HANDLE_VALUE ist, war die Funktion erfolgreich, und der Wert kann als Handle für die geöffnete Datei verwendet werden. Der Rückgabewert INVALID_HANDLE_VALUE gibt an, dass ein Fehler aufgetreten ist.
Mode enthält den Öffnungsmodus und (evtl.) den Freigabemodus. Beide Werte werden mit einem logischen ODER verknüpft. Der Öffnungsmodus muss einer der folgenden Werte sein.
Wert | Bedeutung |
---|---|
Öffnet die Datei ausschließlich zum Lesen. | |
Öffnet die Datei ausschließlich zum Schreiben. Beim Schreiben in die Datei wird der aktuelle Inhalt vollständig ersetzt. | |
Öffnet die Datei zum Ändern des aktuellen Inhalts, anstatt diesen zu ersetzen. |
Der Freigabemodus muss einer der folgenden Werte sein.
Wert | Bedeutung |
---|---|
Andere Anwendungen können auf die Datei entsprechend der FCB-Öffnungsmethode zugreifen. | |
Andere Anwendungen können die Datei nicht öffnen. | |
Andere Anwendungen können die Datei ausschließlich zum Lesen öffnen. | |
Andere Anwendungen können die Datei zum Schreiben, nicht aber zum Lesen öffnen. | |
Andere Anwendungen können die Datei ohne Einschränkungen zum Lesen oder Schreiben öffnen. |
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. Bei ihnen handelt es sich um Low-Level-Routinen für den Dateizugriff. Verwenden Sie für normale Dateioperationen stattdessen AssignFile, Rewrite und Reset.