_lcreat函式 (winbase.h)

  • 發行項

[提供此函式以與16位版本的 Windows 相容。 新的應用程式應該使用 CreateFile 函式。]

建立或開啟指定的檔案。 本檔僅包含用於針對現有程式代碼進行疑難解答。

語法

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

參數

lpPathName

檔案的名稱。 字串必須包含來自 Windows ANSI 字元集的字元。

iAttribute

檔案的屬性。

此參數必須設定為下列其中一個值。

值 意義
0
 一般。 可以讀取或寫入，而不受限制。
1
 唯讀。 無法開啟寫入。
2
 隱藏。 目錄搜尋不到。
4
 系統。 目錄搜尋不到。

傳回值

如果函式成功，則傳回值是檔案句柄。 否則，傳回值會HFILE_ERROR。 若要取得擴充的錯誤資訊，請使用 GetLastError 函式。

備註

如果檔案不存在， _lcreat 會建立並開啟新檔案以供寫入。 如果檔案存在， _lcreat 將檔案大小截斷為零，並開啟檔案以供讀取和寫入。

當函式開啟檔案時，指標會設定為檔案的開頭。

請小心使用 _lcreat 函式。 它可以開啟任何檔案，即使是已經由另一個函式開啟的檔案。

規格需求

需求 值
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

CreateFile