_fsopen, _wfsopen

ouvre un flux de données avec le partage de fichiers.

FILE *_fsopen( 
   const char *filename,
   const char *mode,
   int shflag 
);
FILE *_wfsopen( 
   const wchar_t *filename,
   const wchar_t *mode,
   int shflag 
);

Paramètres

• filename
  Nom du fichier à ouvrir.

• mode
  type d'accès autorisé.

• shflag
  Type de partage autorisé.

Valeur de retour

Chacune de ces fonctions retourne un pointeur vers le flux de données.une valeur de pointeur null indique une erreur.Si filename ou mode est NULL ou une chaîne vide, ces fonctions appellent le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, ces fonctions NULL de retour et errno défini à EINVAL.

Pour plus d'informations sur ces éléments et d'autres codes d'erreur, consultez _doserrno, errno, _sys_errlist, et _sys_nerr.

Notes

La fonction d' _fsopen ouvre le fichier spécifié par filename flux et prépare le fichier pour la lecture partagée suivante ou l'écriture, comme défini par le mode et les arguments d' shflag ._wfsopen est une version à caractère élargi d' _fsopen; les arguments d' filename et d' mode à _wfsopen sont des chaînes à caractères larges._wfsopen et _fsopen se comportent de sinon.

La chaîne de caractères mode spécifie le type d'accès demandé pour le fichier, comme indiqué dans le tableau suivant.

Utilisez les types d' "w" et d' "w+" avec prudence, car ils peuvent détruire des fichiers existants.

Lorsqu'un fichier est ouvert avec le type d'accès d' "a" ou d' "a+" , toutes les opérations d'écriture se produisent à la fin de le fichier.Le pointeur de fichier peut être repositionné à l'aide de fseek ou rewind, mais il est toujours déplacé vers la fin du fichier avant que toute opération d'écriture soit exécutée.Par conséquent, les données existantes ne peuvent pas être remplacées.Lorsque "r+", "w+", ou le type d'accès d' "a+" est spécifié, il autorise la lecture et l'écriture (le fichier est appelé ouvert pour la mise à jour).Toutefois, le basculement entre la lecture et l'écriture, il doit y avoir fsetposintermédiaire, fseek, ou opération de rebobinage .La position actuelle peut être spécifiée pour une opération d' fsetpos ou d' fseek , si vous le souhaitez.Outre les valeurs ci-dessus, l'un des caractères suivants peuvent être inclus dans mode pour spécifier un en mode de traduction pour les nouvelles lignes, et pour la gestion de fichiers.

si t ou b n'est pas donné dans mode, l'à mode de traduction est défini par la variable _fmodede valeur par défaut-mode.Si t ou b est préfixé à l'argument, la fonction échoue et retourne NULL.Pour plus d'informations sur les modes de texte et de binaire, consultez l' E/S de fichier du mode de texte et de binaire.

L'argument shflag est une expression constante se composer de constantes manifestes suivantes, défini dans Share.h.

mappages de routines de texte générique

Configuration requise

Exemple

// crt_fsopen.c

#include <stdio.h>
#include <stdlib.h>
#include <share.h>

int main( void )
{
   FILE *stream;

   // Open output file for writing. Using _fsopen allows us to
   // ensure that no one else writes to the file while we are
   // writing to it.
    //
   if( (stream = _fsopen( "outfile", "wt", _SH_DENYWR )) != NULL )
   {
      fprintf( stream, "No one else in the network can write "
                       "to this file until we are done.\n" );
      fclose( stream );
   }
   // Now others can write to the file while we read it.
   system( "type outfile" );
}

Équivalent .NET Framework

• System::IO : : fichier : : Ouvrez

• System::IO : : FileStream : : FileStream

Voir aussi

Référence

E/S de flux

fclose, _fcloseall

_fdopen, _wfdopen

ferror

_fileno

le fopen, _wfopen

freopen, _wfreopen

_open, _wopen

_setmode

_sopen, _wsopen