функция _lcreat (winbase.h)

  • Статья

[Эта функция предоставляется для совместимости с 16-разрядными версиями Windows. Новые приложения должны использовать функцию CreateFile .]

Создает или открывает указанный файл. Эта документация содержится только для устранения неполадок существующего кода.

Синтаксис

HFILE _lcreat(
  LPCSTR lpPathName,
  int    iAttribute
);

Параметры

lpPathName

Имя файла. Строка должна состоять из символов из набора символов Windows ANSI.

iAttribute

Атрибуты файла.

Для этого параметра необходимо задать одно из следующих значений.

Значение Значение
0
 Нормальный. Может считываться из или записываться в без ограничений.
1
 Только для чтения. Невозможно открыть для записи.
2
 Скрытый. Поиск по каталогу не найден.
4
 System. Поиск по каталогу не найден.

Возвращаемое значение

Если функция выполняется успешно, возвращаемым значением является дескриптор файла. В противном случае возвращаемое значение будет HFILE_ERROR. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .

Комментарии

Если файл не существует, _lcreat создает и открывает новый файл для записи. Если файл существует, _lcreat усекает его до нуля и открывает его для чтения и записи.

Когда функция открывает файл, для указателя устанавливается начало файла.

Используйте функцию _lcreat с осторожностью. Он может открыть любой файл, даже тот, который уже открыт другой функцией.

Требования

Требование Значение
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

CreateFile