_lcreat函式 (winbase.h)
[提供此函式以與16位版本的 Windows 相容。 新的應用程式應該使用 CreateFile 函式。]
建立或開啟指定的檔案。 本檔僅包含用於針對現有程式代碼進行疑難解答。
語法
HFILE _lcreat(
LPCSTR lpPathName,
int iAttribute
);
參數
lpPathName
檔案的名稱。 字串必須包含來自 Windows ANSI 字元集的字元。
iAttribute
檔案的屬性。
此參數必須設定為下列其中一個值。
值 | 意義 |
---|---|
|
一般。 可以讀取或寫入,而不受限制。 |
|
唯讀。 無法開啟寫入。 |
|
隱藏。 目錄搜尋不到。 |
|
系統。 目錄搜尋不到。 |
傳回值
如果函式成功,則傳回值是檔案句柄。 否則,傳回值會HFILE_ERROR。 若要取得擴充的錯誤資訊,請使用 GetLastError 函式。
備註
如果檔案不存在, _lcreat 會建立並開啟新檔案以供寫入。 如果檔案存在, _lcreat 將檔案大小截斷為零,並開啟檔案以供讀取和寫入。
當函式開啟檔案時,指標會設定為檔案的開頭。
請小心使用 _lcreat 函式。 它可以開啟任何檔案,即使是已經由另一個函式開啟的檔案。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | winbase.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |