CreateFile PROTO,

pFilename: PTR BYTE,; Адрес строки, содержащей имя файла

desiredAccess: DWORD,; Требуемый режим доступа

shareMode: DWORD,; Режим совместного использования

lpSecurity: DWORD,; Адрес атрибутов безопасности

creationDisposition: DWORD,; Действия, выполняемые при создании файла

flagsAndAttributes: DWORD,; Атрибуты файла

htemplate: DWORD; Дескриптор файла, используемого в качестве шаблона

Первый параметр функции CreateFile — это адрес нуль-завершенной строки, содержащей частично или полностью определенное имя файла в виде:

устройство: \путь\имя_файла.

Параметр desiredAccess определяет требуемый режим доступа к файлу (по чтению или записи).

Параметр shareMode управляет режимом доступа к открытому файлу со стороны других программ, запущенных в системе.

Параметр lpSecurity - это адрес структуры, с помощью которой в системах Windows NT, 2000 и XP выполняется управление правами доступа к файлу со стороны пользователей.

Значение параметра creationDisposition определяет, какие действия будет выполнять операционная система во время создания файла в случае, если такой файл уже есть или его еще не существует.

Параметр flagsAndAttributes представляет собой набор битов, значение которых определяет атрибуты файла, такие как архивируемый, зашифрованный, обычный, системный или временный.

Параметр htemplate необязательный. Он определяет дескриптор другого открытого ранее шаблонного файла, атрибуты которого (обычные и расширенные) будут использоваться при создании текущего файла. Если шаблонный файл не используется, вместо параметра h template нужно подставить нулевое значение.

Требуемый режим доступа. Задав соответствующее значение параметра desiredAccess, приведенного в табл. 1, программа может получить доступ к файлу по чтению, записи, чтению/записи или запросить доступ к устройству как к файлу. Указанные в табл. 1 значения можно комбинировать. Кроме них существует еще большое количество разных значений флагов, которые не приведены в таблице.

Таблица 1.

Возможные значения параметра desiredAccess

Действия, выполняемые при создании файла. Параметр creationDisposition

определяет, какие действия будет выполнять операционная система во время создания файла

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

В табл. 11.5 перечислены наиболее употребительные значения параметра flagsAndAttributes. (Полный список приведен в документации по Microsoft MSDN.)

Допускается любая комбинация указанных в таблице атрибутов, однако нужно учитывать, что

любой указанный атрибут файла замещает атрибут FlLE_ATTRlBUTE_NORMAL.

Примеры. Ниже приведено несколько примеров вызовов функций, позволяющих прояснить, как создавать и открывать файлы. Чтобы получить дополнительную информацию, обратитесь к описанию функции CreateFile, приведенному в документации Microsoft MSDN.

 

Открытие существующего файла для чтения: