System.SysUtils.FileOpen

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

extern DELPHI_PACKAGE NativeUInt __fastcall FileOpen(const System::UnicodeString FileName, unsigned 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

fmOpenRead

Ouvre le fichier en lecture seulement.

fmOpenWrite

Ouvre le fichier en écriture seulement. L'écriture dans le fichier remplace son contenu actuel.

fmOpenReadWrite

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

fmShareCompat

Le partage est compatible avec la manière dont les FCB sont ouverts.

fmShareExclusive

En aucun cas une autre application ne peut ouvrir le fichier.

fmShareDenyWrite

Les autres applications peuvent ouvrir le fichier en lecture, mais pas en écriture.

fmShareDenyRead

Les autres applications peuvent ouvrir le fichier en écriture, mais pas en lecture.

fmShareDenyNone

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.

Voir aussi

Exemples de code