_sopen_s, _wsopen_s

開啟檔案以供共用。 這些版本的 _sopen 和 _wsopen 具有安全性增強功能，如CRT中的安全性功能中所述。

語法

errno_t _sopen_s(
   int* pfh,
   const char *filename,
   int oflag,
   int shflag,
   int pmode
);
errno_t _wsopen_s(
   int* pfh,
   const wchar_t *filename,
   int oflag,
   int shflag,
   int pmode,
);

參數

pfh
檔案句柄，如果發生錯誤，則為 -1。

filename
檔案名稱

oflag
允許的作業類型。

shflag
容許的共用種類。

pmode
權限設定。

傳回值

非零傳回值指出發生錯誤，在該情況下，errno 會設為下列其中一個值。

errno 值	Condition
EACCES	指定的路徑為目錄，或是檔案為唯讀，但已嘗試「開啟以供寫入」作業。
EEXIST	指定了 _O_CREAT 和 _O_EXCL 旗標，但 filename 已存在。
EINVAL	無效的 oflag、shflag 或 pmode 引數，或者 pfh 或 filename 為 null 指標。
EMFILE	沒有更多可用的檔案描述元。
ENOENT	找不到檔案或路徑。

如果將無效的自變數傳遞至函式，則會叫用無效的參數處理程式，如參數驗證中所述。 如果允許繼續執行， errno 則會設定為 EINVAL，並 EINVAL 傳回 。

如需這些傳回碼和其他傳回碼的詳細資訊，請參閱errno、 _sys_errlist_doserrno和 _sys_nerr。

如果發生錯誤，則會透過 pfh 傳回 -1 （除非 pfh 是 Null 指標）。

備註

_sopen_s 函式會開啟 filename 指定的檔案，並準備檔案，以供共用讀取或寫入 (由 oflag 和 shflag 指定)。 _wsopen_s 是寬字元版本的 _sopen_s； filename 的 _wsopen_s 引數是寬字元字串。 否則，_wsopen_s 和 _sopen_s 的行為即會相同。

根據預設，此函式的全域狀態會限定於應用程式。 若要變更它，請參閱 CRT中的全域狀態。

一般文字常式對應

Tchar.h 常式	_UNICODE 和 _MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_tsopen_s	_sopen_s	_sopen_s	_wsopen_s

整數表達式 oflag 的形成方式是結合一或多個指令清單常數，這些常數定義於 中 <fcntl.h>。 當兩個或多個常數形成自變數oflag時，它們會與位 OR 運算子結合 |

oflag 常數	行為
_O_APPEND	在每次寫入作業之前，將檔案指標移到檔案的結尾。
_O_BINARY	以二進位 (未轉譯) 模式開啟檔案 （如需二進位模式的描述，請參閱 fopen 。
_O_CREAT	建立檔案並開啟以供寫入。 若 filename 指定的檔案存在則無影響。 指定 pmode 時，需要 _O_CREAT 引數。
_O_CREAT | _O_SHORT_LIVED	將檔案建立為暫存盤，如果可能的話，不會排清到磁碟。 指定 pmode 時，需要 _O_CREAT 引數。
_O_CREAT | _O_TEMPORARY	將檔案建立為暫存檔；當最後一個檔案描述項關閉時會刪除檔案。 指定 pmode 時，需要 _O_CREAT 引數。 為了保留應用程式相容性的舊版行為，不會防止其他進程刪除此檔案。
_O_CREAT | _O_EXCL	若 filename 指定的檔案存在，會傳回錯誤值。 搭配 _O_CREAT 使用時才套用。
_O_NOINHERIT	防止建立共用檔案描述項。
_O_RANDOM	指定針對但不限於磁碟的隨機存取進行快取最佳化。
_O_RDONLY	開啟檔案為僅供讀取。 無法使用 或 _O_WRONLY指定 _O_RDWR 。
_O_RDWR	開啟檔案以進行讀取和寫入。 無法使用 或 _O_WRONLY指定 _O_RDONLY 。
_O_SEQUENTIAL	指定針對但不限於磁碟的循序存取進行快取最佳化。
_O_TEXT	以 ANSI 文字 （翻譯） 模式開啟檔案。 （如需詳細資訊，請參閱 文字和二進位模式檔案 I/O 和 fopen。）
_O_TRUNC	開啟檔案，並將檔案截斷為零長度；檔案必須具有寫入權限。 無法使用 指定 。 _O_RDONLY _O_TRUNC 用於搭配 _O_CREAT 以開啟現有檔案或建立檔案。 注意： 旗標會 _O_TRUNC 終結指定檔案的內容。
_O_WRONLY	將檔案開啟為僅供寫入。 無法使用 或 _O_RDWR指定 _O_RDONLY 。
_O_U16TEXT	以 Unicode UTF-16 模式開啟檔案。
_O_U8TEXT	以 Unicode UTF-8 模式開啟檔案。
_O_WTEXT	以 Unicode 模式開啟檔案。

若要指定檔案存取模式，您必須指定 _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-8時，UTF-16數據會轉譯為UTF-8。 檔案的UTF-8編碼內容會在讀取時轉譯為UTF-16。 嘗試以 Unicode 模式讀取或寫入奇數位元組會導致 參數驗證 錯誤。 若要讀取或寫入作為 UTF-8 儲存在您程式裡的資料時，請使用文字或二進位檔案模式，不要使用 Unicode 模式。 您必須負責任何必要的編碼轉譯。

若搭配 _sopen_s (附加模式) 及 _O_WRONLY | _O_APPEND、_O_WTEXT 或 _O_U16TEXT 呼叫 _O_U8TEXT，會先嘗試開啟檔案以供讀取和寫入，再讀取 BOM，然後重新開啟檔案且僅供寫入。 若開啟檔案以供讀取和寫入失敗，則會僅針對寫入開啟檔案，並使用 Unicode 模式設定的預設值。

自變數 shflag 是包含下列其中一個指令清單常數的常數表達式，定義於 中 <share.h>。

shflag 常數	行為
_SH_DENYRW	拒絕對檔案的讀取和寫入存取。
_SH_DENYWR	拒絕對檔案的寫入存取。
_SH_DENYRD	拒絕對檔案的讀取存取。
_SH_DENYNO	允許讀取及寫入權限。

與在 pmode 中不同，_sopen 引數一定是需要的。 當您指定 _O_CREAT時，如果檔案不存在， pmode 請指定檔案的許可權設定，這是在第一次關閉新檔案時設定的。 否則會忽略 pmode。 pmode是整數表達式，其中包含一個或兩個指令清單常數和 _S_IREAD，這些常數_S_IWRITE定義於 中<sys\stat.h>。 提供這兩個常數時，它們會與位 OR 運算子結合。 pmode 的含意如下。

pmode	意義
_S_IREAD	只允許讀取。
_S_IWRITE	允許寫入。 (實際上允許讀取和寫入)。
_S_IREAD | _S_IWRITE	允許讀取和寫入。

如果未指定寫入許可權，則檔案是唯讀的。 在 Windows 作業系統中，所有檔案都是可讀取的;無法授與唯寫許可權。 因此，模式 _S_IWRITE 和 _S_IREAD | _S_IWRITE 相同。

_sopen_s 會在設定權限之前，將目前的檔案權限遮罩套用至 pmode (請參閱_umask.)

需求

函式	必要的標頭	選擇性標頭
_sopen_s	<io.h>	<fcntl.h>、 、 <sys\types.h>、 <sys\stat.h><share.h>
_wsopen_s	<io.h> 或 <wchar.h>	<fcntl.h>、 、 <sys/types.h>、 <sys/stat.h><share.h>

_sopen_s 和 _wsopen_s 是 Microsoft 擴充功能。 如需相容性詳細資訊，請參閱相容性。

範例

請參閱 _locking 的範例。

另請參閱

低階 I/O
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen