_lcreat 函数 (winbase.h)

[提供此函数是为了与 16 位版本的 Windows 兼容。新应用程序应使用 CreateFile 函数。]

创建或打开指定的文件。本文档仅用于对现有代码进行故障排除。

语法

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

lpPathName

文件的名称。字符串必须由 Windows ANSI 字符集中的字符组成。

iAttribute

文件的属性。

此参数必须设置为以下值之一。

如果函数成功，则返回值为文件句柄。否则，返回值HFILE_ERROR。若要获取扩展错误信息，请使用 GetLastError 函数。

如果文件不存在， _lcreat 会创建并打开一个新文件进行写入。如果文件确实存在， _lcreat 将文件大小截断为零，并打开它进行读取和写入。

当函数打开文件时，指针将设置为文件的开头。

请谨慎使用 _lcreat 函数。它可以打开任何文件，甚至一个文件已经由另一个函数打开。