_lcreat, fonction (winbase.h)

[Cette fonction est fournie à des fins de compatibilité avec les versions 16 bits de Windows. Les nouvelles applications doivent utiliser la fonction CreateFile .]

Crée ou ouvre le fichier spécifié. Cette documentation est incluse uniquement pour la résolution des problèmes de code existant.

Syntaxe

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

Paramètres

lpPathName

Nom du fichier. La chaîne doit se composer de caractères du jeu de caractères ANSI Windows.

iAttribute

Attributs du fichier.

Ce paramètre doit être défini sur l’une des valeurs suivantes.

Valeur	Signification
0	Normal. Peut être lu ou écrit dans sans restriction.
1	Lecture seule. Impossible d’ouvrir pour écriture.
2	Masqué. Introuvable par recherche d’annuaire.
4	System. Introuvable par recherche d’annuaire.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle de fichier. Sinon, la valeur de retour est HFILE_ERROR. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .

Remarques

Si le fichier n’existe pas, _lcreat crée et ouvre un fichier à écrire. Si le fichier existe, _lcreat tronque la taille du fichier à zéro et l’ouvre pour la lecture et l’écriture.

Lorsque la fonction ouvre un fichier, le pointeur est défini sur le début du fichier.

Utilisez la fonction _lcreat avec précaution. Il peut ouvrir n’importe quel fichier, même un fichier déjà ouvert par une autre fonction.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CreateFile