_sopen, _wsopen

Ouvre un fichier pour le partage. Des versions plus sécurisées de ces fonctions sont disponibles : voir _sopen_s, _wsopen_s.

Syntaxe

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

Paramètres

filename
Nom de fichier.

oflag
Type d'opérations autorisées.

shflag
Type de partage autorisé.

pmode
Paramètre d'autorisation.

Valeur retournée

Chacune de ces fonctions retourne un descripteur de fichier pour le fichier ouvert.

S’il filename s’agit d’un oflagNULL pointeur ou s’il oflagshflag ne se trouve pas dans une plage de valeurs valide, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent -1 et affectent à errno l'une des valeurs suivantes.

Pour plus d’informations sur ces codes de retour et d’autres codes de retour, consultez _sys_nerr.

Notes

La fonction _sopen ouvre le fichier spécifié par filename et prépare le fichier pour la lecture ou l'écriture partagée, comme défini par oflag et shflag. _wsopen est une version à caractères larges de _sopen; l'argument filename de _wsopen est une chaîne à caractères larges. Sinon,_wsopen et _sopen se comportent de la même façon.

Par défaut, l’état global de cette fonction est limité à l’application. Pour le modifier, consultez l’état global dans le CRT.

Mappages de routines de texte générique

L’expression oflag entière est formée en combinant une ou plusieurs des constantes manifeste suivantes, qui sont définies dans <fcntl.h>. Lorsque deux constantes ou plus forment l’argument oflag, elles sont combinées à l’opérateur OR au niveau du bit ( | ).

Pour spécifier le mode d'accès au fichier, vous devez spécifier _O_RDONLY, _O_RDWR ou _O_WRONLY. Il n’existe aucune valeur par défaut pour le mode d’accès.

Quand un fichier est ouvert en mode Unicode à l'aide d'_O_WTEXT, _O_U8TEXT ou _O_U16TEXT, les fonctions d'entrée traduisent les données qui sont lues à partir du fichier en données UTF-16 stockées comme type wchar_t. Les fonctions qui écrivent dans un fichier ouvert en mode Unicode attendent des mémoires tampons qui contiennent des données UTF-16 stockées comme type wchar_t. Si le fichier est encodé en UTF-8, les données UTF-16 sont traduites en UTF-8 lorsqu’elles sont écrites. Le contenu encodé en UTF-8 du fichier est traduit en UTF-16 lorsqu’il est lu. Toute tentative de lecture ou d'écriture d'un nombre impair d'octets en mode Unicode provoque une erreur de validation de paramètre . Pour lire ou écrire des données stockées dans votre programme au format UTF-8, utilisez un mode de fichier binaire ou texte au lieu d'un mode Unicode. Vous êtes responsable de toute traduction d’encodage requise.

Si _sopen est appelée avec _O_WRONLY | _O_APPEND (mode Append) et _O_WTEXT, _O_U16TEXT ou _O_U8TEXT, elle tente d'abord d'ouvrir le fichier pour la lecture et l'écriture, de lire la marque BOM, puis de le rouvrir pour l'accès en écriture uniquement. Si l'ouverture du fichier pour l'accès en lecture et en écriture échoue, elle ouvre le fichier pour l'accès en écriture uniquement et utilise la valeur par défaut pour le paramètre de mode Unicode.

L’argument shflag est une expression constante composée d’une des constantes manifeste suivantes, qui sont définies dans <share.h>.

L'argument pmode est obligatoire uniquement quand _O_CREAT est spécifié. Si le fichier n’existe pas, pmode spécifie les paramètres d’autorisation du fichier, qui sont définis lorsque le nouveau fichier est fermé la première fois. Sinon, pmode est ignoré. pmode est une expression entière qui contient une ou les deux constantes _S_IWRITE de manifeste et _S_IREAD, qui sont définies dans <sys\stat.h>. Lorsque les deux constantes sont fournies, elles sont combinées avec l’opérateur OR au niveau du bit. La signification de pmode est la suivante.

Si l’autorisation d’écriture n’est pas donnée, le fichier est en lecture seule. Dans le système d’exploitation Windows, tous les fichiers sont lisibles ; il n’est pas possible d’accorder une autorisation en écriture seule. Par conséquent, les modes _S_IWRITE et _S_IREAD | _S_IWRITE sont équivalents.

_sopen applique le masque d'autorisation de fichier actif à pmode avant que les autorisations soient définies. Pour plus d’informations, consultez _umask.

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Consultez l’exemple pour _locking.

Voir aussi

E/S de bas niveau
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen