_sopen, _wsopen

Открывает файл для общего доступа. Доступны более безопасные версии этих функций: см. раздел _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 ]
);

Параметры

filename
Имя файла.

oflag
Разрешенные типы операций.

shflag
Разрешенные типы общего доступа.

pmode
Настройка разрешений.

Возвращаемое значение

Каждая из этих функций возвращает дескриптор файла для открытого файла.

Если filename или oflag является NULL указателем или shflag oflag не находится в допустимом диапазоне значений, вызывается обработчик недопустимых параметров, как описано в разделе проверки параметров. Если разрешается продолжать выполнение, эти функции возвращают -1 и задают для errno одно из следующих значений.

Дополнительные сведения об этих и других кодах возврата см. в разделе errno, _doserrnoи _sys_nerr_sys_errlist.

Замечания

Функция _sopen открывает файл, указанный параметром filename, и готовит его к общему доступу для чтения или записи, как задано параметрами oflag и shflag. _wsopen — это версия _sopenс расширенными символами; аргумент filename для _wsopen — строка расширенных символов. Поведение_wsopen и _sopen идентично в противном случае.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить его, ознакомьтесь с глобальным состоянием в CRT.

Сопоставления подпрограмм универсального текста

Целочисленное выражение oflag формируется путем объединения одной или нескольких из следующих констант манифеста, определенных в <fcntl.h>. Если две или более констант образуют аргумент oflag, они объединяются с побитовой оператором OR ( | ).

Чтобы указать режим доступа к файлу, необходимо задать _O_RDONLY, _O_RDWR или _O_WRONLY. Значение по умолчанию для режима доступа отсутствует.

Если файл открывается в режиме Юникода с помощью флагов _O_WTEXT, _O_U8TEXT или _O_U16TEXT, функции ввода преобразуют данные, считываемые из файла в данные UTF-16, хранимые с типом wchar_t. Затем функции, которые выполняют запись в файл, открытый в режиме Юникода, ожидают буферы, содержащие данные UTF-16, хранимые с типом wchar_t. Если файл закодирован как UTF-8, данные UTF-16 превратятся в UTF-8 при записи. Содержимое в кодировке UTF-8 преобразуется в UTF-16 при чтении. Попытка чтения или записи нечетного числа байт в режиме Юникода приводит к возникновению ошибки проверки параметра . Для чтения или записи данных, хранимых в программе в кодировке UTF-8, используйте режим текстового или двоичного файла вместо режима Юникода. Вы несете ответственность за любой необходимый перевод кодировки.

Если _sopen вызывается с флагами _O_WRONLY | _O_APPEND (режим добавления) и _O_WTEXT, _O_U16TEXT или _O_U8TEXT, сначала выполняется попытка открыть файл для чтения и записи, считывается метка порядка байтов, а затем файл снова открывается только для записи. Если происходит сбой открытия файла для чтения и записи, файл открывается только для записи и для параметра режима Юникода используется значение по умолчанию.

Аргумент shflag — это константное выражение, состоящее из одной из следующих констант манифеста, определенных в <share.h>.

Аргумент pmode обязателен, только если указан флаг _O_CREAT. Если файл не существует, pmode указывает параметры разрешений файла, которые задаются при первом закрытии нового файла. В противном случае pmode игнорируется. pmode представляет собой целочисленное выражение, содержащее одну или обе константы манифеста _S_IWRITE и _S_IREADопределенные в <sys\stat.h>. При указании обеих констант они объединяются с побитовой оператором OR. Значение параметра pmode следующее.

Если разрешение на запись не задано, файл доступен только для чтения. В операционной системе Windows все файлы доступны для чтения; Невозможно предоставить разрешение только для записи. Поэтому режимы _S_IWRITE и _S_IREAD | _S_IWRITE эквивалентны.

_sopen применяет текущую маску разрешений файла к pmode до настройки разрешений. Дополнительные сведения см. в разделе _umask.

Требования

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

Пример см. в примере _locking.

См. также

Низкоуровневый ввод-вывод
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen