_sopen, _wsopen

Abre um arquivo para compartilhamento. Estão disponíveis versões mais seguras destas funções: ver _sopen_s, _wsopen_s.

Sintaxe

int _sopen(
   const char *filename,
   int oflag,
   int shflag [,
   int pmode ]
);
int _wsopen(
   const wchar_t *filename,
   int oflag,
   int shflag [,
   int pmode ]
);

Parâmetros

filename
Nome do arquivo.

oflag
O tipo de operações permitidas.

shflag
O tipo de partilha permitido.

pmode
Configuração de permissão.

Valor de retorno

Cada uma dessas funções retorna um descritor de arquivo para o arquivo aberto.

Se filename ou oflag for um NULL ponteiro, ou se oflag estiver ou shflag não dentro de um intervalo válido de valores, o manipulador de parâmetros inválido será invocado, conforme descrito em Validação de parâmetros. Se a execução for permitida para continuar, essas funções retornarão -1 e definidas errno como um dos seguintes valores.

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

Observações

A _sopen função abre o arquivo especificado por filename e prepara o arquivo para leitura ou gravação compartilhada, conforme definido por oflag e shflag. _wsopené uma versão de caracteres largos de ; o filename argumento para _wsopen é uma cadeia de _sopencaracteres largos. _wsopen e _sopen comportar-se de forma idêntica de outra forma.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterá-lo, consulte estado global noCRT .

Mapeamentos de rotina de texto genérico

A expressão oflag inteira é formada pela combinação de uma ou mais das seguintes constantes de manifesto, que são definidas em <fcntl.h>. Quando duas ou mais constantes formam o argumento oflag, elas são combinadas com o operador bitwise-OR ( | ).

Para especificar o modo de acesso ao arquivo, você deve especificar _O_RDONLY, _O_RDWRou _O_WRONLY. Não há nenhum valor padrão para o modo de acesso.

Quando um arquivo é aberto no modo Unicode usando _O_WTEXT, _O_U8TEXTou _O_U16TEXT, as funções de entrada convertem os dados lidos do arquivo em dados UTF-16 armazenados como tipo wchar_t. As funções que gravam em um arquivo aberto no modo Unicode esperam buffers que contenham dados UTF-16 armazenados como tipo wchar_t. Se o arquivo for codificado como UTF-8, os dados UTF-16 serão convertidos em UTF-8 quando forem gravados. O conteúdo codificado em UTF-8 do arquivo é traduzido para UTF-16 quando é lido. Uma tentativa de ler ou gravar um número ímpar de bytes no modo Unicode causa um erro de validação de parâmetro. Para ler ou gravar dados armazenados em seu programa como UTF-8, use um modo de texto ou arquivo binário em vez de um modo Unicode. Você é responsável por qualquer tradução de codificação necessária.

Se _sopen for chamado com _O_WRONLY | _O_APPEND (modo de acréscimo) e _O_WTEXT, _O_U16TEXTou , ele _O_U8TEXTprimeiro tentar abrir o arquivo para leitura e gravação, leia a lista técnica e, em seguida, reabra-o apenas para gravação. Se a abertura do arquivo para leitura e gravação falhar, ele abrirá o arquivo somente para gravação e usará o valor padrão para a configuração do modo Unicode.

O argumento shflag é uma expressão constante que consiste em uma das seguintes constantes manifestas, que são definidas em <share.h>.

O pmode argumento é necessário apenas quando _O_CREAT é especificado. Se o arquivo não existir, pmode especifica as configurações de permissão do arquivo, que são definidas quando o novo arquivo é fechado pela primeira vez. Caso contrário, pmode é ignorado. pmode é uma expressão inteira que contém uma ou ambas as constantes _S_IWRITE de manifesto e _S_IREAD, que são definidas em <sys\stat.h>. Quando ambas as constantes são dadas, elas são combinadas com o operador bitwise-OR. O significado de pmode é o seguinte.

Se a permissão de gravação não for dada, o arquivo será somente leitura. No sistema operacional Windows, todos os arquivos são legíveis; Não é possível dar permissão somente gravação. Portanto, os modos _S_IWRITE e _S_IREAD | _S_IWRITE são equivalentes.

_sopen Aplica a máscara de permissão de arquivo atual a pmode antes que as permissões sejam definidas. Para obter mais informações, consulte _umask.

Requerimentos

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Veja o exemplo para _locking.

Ver também

E/S de baixo nível
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen