_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 指针，或者如果 oflag 或 shflag 不在有效值范围内，则调用无效参数处理程序，如参数验证中所述。 如果允许执行继续，则这些函数将返回 -1 并将 errno 设置为以下值之一。

有关这些和其他的返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

注解

_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 在 Unicode 模式下打开文件时，输入函数会将从该文件中读取的数据转换为存储为 wchar_t 类型的 UTF-16 数据。 写入到在 Unicode 模式下打开的文件的函数需要包含存储为 wchar_t类型的 UTF-16 数据的缓冲区。 如果将文件编码为 UTF-8，则在写入它时，UTF-16 数据会转换为 UTF-8。 在读取它时，该文件的 UTF-8 编码的内容会转换为 UTF-16。 尝试在 Unicode 模式下读取或写入奇数个字节会导致 参数验证 错误。 若要读取或写入在你的程序中存储为 UTF-8 的数据，请使用文本或二进制文件模式，而不是 Unicode 模式。 你应负责所有必需的编码转换。

如果使用 _sopen_O_WRONLY | （追加模式）和 _O_APPEND、_O_WTEXT 或 _O_U16TEXT 调用 _O_U8TEXT，则它首先会尝试打开该文件以供读取和写入、读取 BOM，然后重新打开它以供只写。 如果无法打开该文件以供读取和写入，则它将打开该文件以供只写，并使用 Unicode 模式设置的默认值。

shflag 参数是常量表达式，它包含在 <share.h> 中定义的以下清单常量之一。

仅在指定 pmode 时，需要使用 _O_CREAT 参数。 如果该文件不存在，则 pmode 将指定在首次关闭新文件时设置的该文件的权限设置。 否则，将忽略 pmode。 pmode 是一个整数表达式，它包含在 _S_IWRITE 中定义的以下 _S_IREAD 和 <sys\stat.h> 常量之一或两个。 当给定这两个常量时，将使用按位“或”运算符合并它们。 pmode 的含义如下。

如果未授予写入权限，则该文件为只读。 在 Windows 操作系统中，所有文件均可读；不可能提供只写权限。 因此，模式 _S_IWRITE 和 _S_IREAD | _S_IWRITE 是等效的。

在设置这些权限之前，_sopen 会将当前文件权限掩码应用到 pmode。 有关详细信息，请参阅 _umask。

要求

有关兼容性的详细信息，请参阅 兼容性。

示例

请参阅 _locking 的示例。

另请参阅

低级别 I/O
_close
_creat、_wcreat
fopen、_wfopen
_fsopen、_wfsopen
_open、_wopen