_sopen, _wsopen

abre un archivo para compartir.Versiones más seguras de estas funciones están disponibles; vea _sopen_s, _wsopen_s.

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
    Nombre de archivo.

  • oflag
    tipo de operaciones permitidas.

  • shflag
    tipo de uso compartido permitido.

  • pmode
    configuración de permisos.

Valor devuelto

Cada una de estas funciones devuelve descriptor de archivo para el archivo abierto.

Si filename o oflag es un puntero de NULL , o si oflag o shflag no está dentro de un intervalo válido de valores, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, estas funciones devuelven -1 y errno establecido en uno de los valores siguientes.

  • EACCES
    La ruta especificada es un directorio, o el archivo es de sólo lectura, pero una operación de la Abrir-para-escritura se probó.

  • EEXIST
    _O_CREAT e indicadores de _O_EXCL se especificaron, pero filename ya existe.

  • EINVAL
    oflag no válido o argumento de shflag .

  • EMFILE
    No más de descriptores de archivo disponibles.

  • ENOENT
    archivo o ruta no encontrada.

Para obtener más información sobre éstos y otros códigos de retorno, vea _doserrno, errno, _sys_errlist, y _sys_nerr.

Comentarios

La función de _sopen abre el archivo especificado por filename y prepara el archivo para leer o escribir compartida, como definido por oflag y shflag._wsopen es una versión con caracteres anchos de _sopen; el argumento de filename a _wsopen es una cadena de caracteres._wsopen y _sopen se comportan exactamente igual de otra manera.

Asignaciones de la rutina de texto genérico

rutina de Tchar.h

_UNICODE y _MBCS no definido

_MBCS definido

_UNICODE definido

_tsopen

_sopen

_sopen

_wsopen

La expresión de entero oflag se forma combinando uno o más de las constantes de manifiesto siguientes, definidos en el archivo Fcntl.h.Cuando dos o más constantes forman el argumento oflag, se combinan con bit a bit el operador ( | ).

  • _O_APPEND
    Coloca un puntero de archivo en el final del archivo antes de cada operación de escritura.

  • _O_BINARY
    Abra un archivo en modo (sin traducir) binario.(Vea fopen para una descripción del modo binario).

  • _O_CREAT
    Crea y abre el nuevo archivo para escribir.no tiene ningún efecto si existe el archivo especificado por filename .se requiere el argumento de pmode cuando se especifica _O_CREAT .

  • _O_CREAT| _O_SHORT_LIVED
    Cree un archivo como temporal y si es posible no lo vacío en el disco.se requiere el argumento de pmode cuando se especifica _O_CREAT .

  • _O_CREAT| _O_TEMPORARY
    cree un archivo como temporal; se elimina el archivo cuando se cierra el descriptor de archivo pasado.se requiere el argumento de pmode cuando se especifica _O_CREAT .

  • _O_CREAT| _O_EXCL
    devuelve un valor de error si existe un archivo especificado por filename .Solo se aplica cuando se utiliza con _O_CREAT.

  • _O_NOINHERIT
    Evita la creación de un archivo compartido descriptor de archivo.

  • _O_RANDOM
    Especifica principalmente de acceso aleatorio desde el disco.

  • _O_RDONLY
    Abre un archivo para leer solo; no se puede especificar con _O_RDWR o _O_WRONLY.

  • _O_RDWR
    Archivo de Abrir para la lectura y escritura; no se puede especificar con _O_RDONLY o _O_WRONLY.

  • _O_SEQUENTIAL
    Especifica principalmente de acceso secuencial desde el disco.

  • _O_TEXT
    Abra un archivo en modo de texto (traducido).(Para obtener más información, vea E/S de archivo de texto y el modo binario y fopen.)

  • _O_TRUNC
    Abra un archivo y lo trunca a la longitud cero; el archivo debe tener permisos de escritura.No puede especificar este marcador con _O_RDONLY._O_TRUNC utilizado con _O_CREAT abre un archivo existente o cree un nuevo archivo.

    [!NOTA]

    El indicador de _O_TRUNC destruye el contenido del archivo especificado.

  • _O_WRONLY
    Abre un archivo para escribir sólo; no se puede especificar con _O_RDONLY o _O_RDWR.

  • _O_U16TEXT
    Abra el archivo en el modo de Unicode UTF-16.

  • _O_U8TEXT
    Abra el archivo en modo UTF-8 Unicode.

  • _O_WTEXT
    Abra el archivo en el modo de Unicode.

Para especificar el modo de acceso a archivos, debe especificar _O_RDONLY, _O_RDWR, o _O_WRONLY.no hay valor predeterminado para el modo de acceso.

Si _sopen lleva _O_WRONLY|_O_APPEND (modo Anexar) y _O_WTEXT, _O_U16TEXT, o _O_U8TEXT, primero se intenta abrir el archivo para leer y escribir, leer el BOM, vuelva a abrirlo para escribir únicamente.Si el archivo se abre para los errores de lectura y escritura, abrirá el archivo para escribir sólo y usará el valor predeterminado para establecer el modo de Unicode.

El argumento shflag es una expresión constante el constar de las constantes de manifiesto siguientes, definidos en Share.h.

  • _SH_DENYRW
    Deniega el acceso de lectura y escritura en un archivo.

  • _SH_DENYWR
    Deniega el acceso de escritura a un archivo.

  • _SH_DENYRD
    Deniega el acceso de lectura a un archivo.

  • _SH_DENYNO
    permite el acceso de lectura y escritura.

Se requiere el argumento de pmode sólo cuando se especifica _O_CREAT.Si el archivo no existe, pmode especifica las configuraciones de permisos del archivo, que se establecen cuando se cierra el nuevo archivo por primera vez.si no pmode se omite.pmode es una expresión de tipo entero que contiene una o ambas de las constantes del manifiesto _S_IWRITE y _S_IREAD, definido en SYS \Stat .h.Cuando se dan ambas constantes, se combinan con bit a bit el operador.El significado de pmode es la siguiente.

  • _S_IWRITE
    Escribir permitida.

  • _S_IREAD
    lectura permitida.

  • _S_IREAD | _S_IWRITE
    lectura y escritura permitidas.

Si el permiso de escritura no se especifica, el archivo es de sólo lectura.En el sistema operativo Windows, todos los archivos son legibles; no es posible asignar el permiso de solo escritura.así, los modos _S_IWRITE y _S_IREAD | _S_IWRITE son equivalentes.

_sopen aplica la máscara actual de los permisos de archivo a pmode antes de establecer los permisos (vea _umask).

Requisitos

rutina

Encabezado necesario

encabezado opcional

_sopen

<io.h>

<fcntl.h> , <sistema/types.h> , <sistema/stat.h> , <share.h>

_wsopen

<io.h> o <wchar.h>

<fcntl.h> , <sistema/types.h> , <sistema/stat.h> , <share.h>

Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

Vea el ejemplo para el _locking.

Equivalente en .NET Framework

No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Vea también

Referencia

E/S de bajo nivel

_close

_creat, _wcreat

fopen, _wfopen

_fsopen, _wfsopen

_open, _wopen