System.SysUtils.FileOpen
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);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Description
Ouvre un fichier en utilisant le mode d'accès spécifié.
Utilisez FileOpen pour ouvrir un fichier et obtenir un handle de fichier. La valeur du mode d'accès résulte d'un ou logique entre l'une des constantes fmOpen et l'une des constantes fmShare définies dans Constantes de mode d'ouverture de fichier. Si la valeur renvoyée n'est pas INVALID_HANDLE_VALUE, la fonction s'est bien déroulée et la valeur représente le handle du fichier ouvert. Si la valeur renvoyée est INVALID_HANDLE_VALUE, cela indique qu'une erreur s'est produite.
Le paramètre Mode est le résultat d'un "ou" logique entre le mode d'ouverture et probablement le mode de partage. Le mode d'ouverture doit prendre l'une des valeurs suivantes :
Valeur | Signification |
---|---|
Ouvre le fichier en lecture seulement. | |
Ouvre le fichier en écriture seulement. L'écriture dans le fichier remplace son contenu actuel. | |
Ouvre le fichier pour modifier le contenu en cours plutôt que de le remplacer. |
Le mode de partage peut prendre l'une des valeurs suivantes.
Valeur | Signification |
---|---|
Le partage est compatible avec la manière dont les FCB sont ouverts. | |
En aucun cas une autre application ne peut ouvrir le fichier. | |
Les autres applications peuvent ouvrir le fichier en lecture, mais pas en écriture. | |
Les autres applications peuvent ouvrir le fichier en écriture, mais pas en lecture. | |
Aucune tentative n'est effectuée pour empêcher les autres applications de lire ou d'écrire dans le fichier. |
Remarque : Nous ne conseillons pas l'utilisation de gestionnaires de fichiers en langage Delphi non natif, tels queFileOpen. Ces routines correspondent aux routines système et renvoient des handles de fichier OS, pas des variables de fichier Delphi normales. Il s'agit de routines d'accès au fichier de bas niveau. Pour des opérations normales sur les fichiers, utilisez plutôt AssignFile, Rewrite et Reset.