_fsopen, _wfsopen

Abre um fluxo com o compartilhamento de arquivos.

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

Parâmetros

• filename
  Nome do arquivo para em em aberto.

• mode
  Tipo de acesso permitido.

• shflag
  Tipo de compartilhamento permitido.

Valor de retorno

Cada uma dessas funções retorna um ponteiro para o fluxo.Um valor de ponteiro nulo indica um erro.If filename ou mode é NULL ou uma seqüência vazia, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornam NULL e conjunto errno para EINVAL.

Para obter mais informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist e _sys_nerr.

Comentários

The _fsopen função abre o arquivo especificado por filename sistema autônomo um fluxo e prepara o arquivo para subseqüente compartilhada leitura ou gravação, conforme definido pelo modo e shflag argumentos. _wfsopen é uma versão de caractere largo da _fsopen; o filename e mode argumentos para _wfsopen são seqüências de caracteres largos. _wfsopen e _fsopen tenham comportamento idêntico caso contrário.

O caractere de seqüência de caracteres mode Especifica o tipo de acesso solicitado para o arquivo, sistema autônomo mostrado na tabela seguinte.

Use o "w" e "w+" tipos com cuidado, pois elas podem destruir sistema autônomo arquivos existentes.

Quando um arquivo for aberto com o "a" ou "a+" tipo de acesso gravar todas as operações ocorrem ao participante do arquivo. O ponteiro do arquivo pode ser reposicionado fseek ou rewind, mas ele é sempre retornado ao participante do arquivo antes de escrever nenhuma operação é executada. Assim, os dados existentes não podem ser substituídos.Quando o "r+", "w+", ou "a+" tipo de acesso for especificado, tanto leitura e gravação são permitidos (o arquivo é considerado em aberto para atualização). No entanto, ao alternar entre a leitura e gravação, deve haver um intermediárias fsetpos, fseek, or retroceder operação.A posição corrente pode ser especificada para o fsetpos ou fseek operação, se desejado. Juntamente com os valores acima, um dos seguintes caracteres pode ser incluído no mode Para especificar o modo de tradução para novas linhas.

If t ou b não é fornecido na mode, o modo de tradução é definido pela variável modo padrão _fmode. If t ou b tem o prefixo para o argumento, a função falha e retorna NULL. Para obter uma abordagem de texto e modos de binários, consulte Texto e o modo binário E/s de arquivos.

O argumento shflag é uma expressão constante que pode ser um das seguintes constantes manifesto, definidas no Share.h.

Mapeamentos de rotina de texto genérica

Requisitos

Exemplo

// 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" );
}

No one else in the network can write to this file until we are done.

Equivalente do NET Framework

• sistema::IO::arquivo::em aberto

• sistema::IO::FileStream::FileStream

Consulte também

Referência

Fluxo de E/S

fclose, _fcloseall

_fdopen, _wfdopen

ferror

_fileno

fopen, _wfopen

freopen, _wfreopen

_Open, _wopen

_setmode

_sopen, _wsopen