CreateFile

Prototypes


HANDLE CreateFile(LPCSTR Fichier, LONG Acces, LONG Partage, SECURITY_ATTRIBUTES *AttributDeSecurites, LONG Mode, FILE_ATTRIBUTE_NORMAL Attributs, void *Inutile);

Description

Ouvre le fichier Fichier selon les conventions suivantes :

Le mode d'accès donné par Acces.
Le mode d'accès est soit :
- GENERIC_READ pour lire.
- GENERIC_WRITE pour écrire.
Le mode de partage donné par Partage.
Le mode de partage est soit :
- FILE_SHARE_READ pour un partage en lecture.
- FILE_SHARE_WRITE pour un partage en écriture.
Les attributs de sécurité donnés par AttributDeSecurites.
Le mode d'ouverture donné par Mode.
Le mode d'ouverture est soit :
- 0 pour le mode par défaut.
- OPEN_ALWAYS pour forcer l'ouverture.
Les attributs du fichier donné par Attributs.
La valeur est alors FILE_ATTRIBUTE_NORMAL.
Un paramètre inutile.
En pratique, la valeur passée est NULL.

Cette fonction sert également à ouvrir un tuyau nommé déjà existant.

Le résultat est le handle sur le fichier.

Exemple


#include <windows.h>

#include <winbase.h>



SECURITY_ATTRIBUTES AttributDeSecurites;

HANDLE Fichier;



...

AttributDeSecurites.nLength=sizeof(SECURITY_ATTRIBUTES); 

AttributDeSecurites.bInheritHandle=TRUE;

AttributDeSecurites.lpSecurityDescriptor=NULL;

Fichier=CreateFile((LPCSTR)"c:\\tmp\\essai.txt", GENERIC_READ, FILE_SHARE_READ, &AttributDeSecurites, 0, FILE_ATTRIBUTE_NORMAL, NULL);

if (!Fichier)


   {

   ...

   }

...

CloseHandle(Fichier);

Avertissement

Le séparateur de répertoire doit être le caractère division inversée \.

Si le chemin n'est pas précisé, le fichier est cherché dans le répertoire courant du processus.

Si le fichier ne peut être ouvert, le résultat est HFILE_ERROR.

Le fichier doit être fermé par CloseHandle.

Voir aussi

CloseHandle pour fermer un fichier. DeleteFile pour supprimer un fichier.