Создание и открытие файлов

Когда приложение использует функцию CreateFile, то должно использовать параметр dwDesiredAccess, чтобы определить, будет ли оно читать из файла, записывать в файл, или делать то и другое вместе. Это известно нам как режим доступа (access mode). Приложение должно также установить и какое выбрать действие, если файл уже существует. Например, прикладная программа может вызвать функцию CreateFile с флажком CREATE_ALWAYS, которая создает файл, если он не существует и переписывает файл, если он существует.

Приложение также может использовать функцию CreateFile, чтобы определить, допускает ли оно совместно использовать файл для чтения, записи, то и другое вместе, или не допускает ни того, ни другого действия. Это известно нам как режим совместного использования (sharing mode). Открытый файл, который не используется совместно,  не может открыться снова и приложением, которое открыло его, и другим приложением до тех пор, пока его дескриптор не будет закрыт.

Когда процесс пытается открыть файл, который уже был открыт в режиме совместного доступа, система сравнивает затребованный доступ и режимы совместного доступа, который был определен, когда файл открывался. Если Вы установили режим доступа, который находится в противоречии с режимом совместного доступа, определенным при предыдущем открытии, вызов CreateFile завершается ошибкой совместного доступа (ERROR_SHARING_VIOLATION). Если Вы определяете использование режима совместного доступа, который находится в противоречии с режимом доступа, определенным при предыдущем открытии, вызов CreateFile завершается ошибкой совместного доступа.

В дополнение к стандартным атрибутам файла, Вы можете также задать и атрибуты защиты, включив указатель на структуру SECURITY_ATTRIBUTES, как четвертый параметр. Однако, лежащая в основе файловая система должна поддерживать эту систему безопасности для этих атрибутов, чтобы они оказывали хоть какое-то влияние. Дополнительную информацию об атрибутах защиты смотри в статье Управление доступом.

• Сбрасывает существующие атрибуты файла (CREATE_ALWAYS  только с существующим файлом).
• Объединяет атрибуты  и флажки файла, определенные параметром dwFlagsAndAttributes с FILE_ATTRIBUTE_ARCHIVE.
• Устанавливает нулевую длину файла.
• Если определяется параметр hTemplateFile, то копирует дополнительные атрибуты, предоставленные шаблонным файлом, в новый файл.
• Устанавливает дескриптор безопасности (SD), заданный  членом lpSecurityDescriptor структуры SECURITY_ATTRIBUTES (исключается, когда используется CREATE_ALWAYS на существующем файле).

• Объединяет флажки файла, определенные параметром dwFlagsAndAttributes с существующими атрибутами файла. CreateFile игнорирует атрибуты файла, заданные dwFlagsAndAttributes.
• Устанавливает длину файла согласно значению параметра dwCreationDisposition.
• Игнорирует параметр hTemplateFile.
• Игнорирует член lpSecurityDescriptor структуры SECURITY_ATTRIBUTES. Остальные члены структуры используются (например, bInheritHandle указывает, может ли дескриптор файла быть унаследован).

Пример: Открытие файла  для чтения

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

#include <windows.h>
#include <stdio.h>

HANDLE hFile; 
 
hFile = CreateFile(TEXT("myfile.txt"),    // открываемый файл
                   GENERIC_READ,          // открываем для чтения
                   FILE_SHARE_READ,       // для совместного чтения
                   NULL,                  // защита по умолчанию
                   OPEN_EXISTING,         // только существующий файл
                   FILE_ATTRIBUTE_NORMAL, // обычный файл
                   NULL);                 // атрибутов шаблона нет
 
if (hFile == INVALID_HANDLE_VALUE) 
{ 
    printf("Could not open file (error %d)\n", GetLastError());
    return 0;
}

Пример: Открытие файла  для записи

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

#include <windows.h>
#include <stdio.h>

HANDLE hFile; 
 
hFile = CreateFile(TEXT("myfile.txt"),    // создаваемый файл
                   GENERIC_WRITE,         // открывается для записи
                   0,                     // совместно не используется
                   NULL,                  // защита по умолчанию
                   CREATE_ALWAYS,         // переписывает существующий
                   FILE_ATTRIBUTE_NORMAL | // обычный файл
                   FILE_FLAG_OVERLAPPED,  // асинхронный ввод/вывод I/O
                   NULL);                 // атрибутов шаблона нет

if (hFile == INVALID_HANDLE_VALUE) 
{ 
    printf("Could not open file (error %d)\n", GetLastError());
    return 0;
}