Файловые системы Работа с файлами в Windows API

системе, используется функция
DWORD GetLogicalDrives( void )
Каждый установленный бит возвращаемого значения

соответствует существующему в системе логическому устройству. Например, если в системе существуют диски A:, C: и D:, то возвращаемое функцией значение равно 13(десятичное).
Функция
DWORD GetLogicalDrivesStrings( DWORD cchBuffer, LPTSTR lpszBuffer)
заполняет lpszBuffer информацией о корневом каталоге каждого логического диска в системе. В приведенном выше примере буфер будет заполнен символами
A:\C:\D:\
параметр cchBuffer определяет длину буфера. Функция возвращает реальную длину буфера, необходимую для размещения всей информации.

lpszRootPathName )
В качестве параметра ей передается символическое имя корневого каталога

(напр. A:\), а возвращаемое значение может быть одно из следующих:

GetVolumeInformation. Она заполняет параметры информацией об имени тома, названии файловой

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

name of the file
DWORD dwDesiredAccess, // access (read-write) mode

DWORD dwShareMode, // share mode
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
// pointer to security descriptor
DWORD dwCreationDistribution,// how to create
DWORD dwFlagsAndAttributes, // file attributes
HANDLE hTemplateFile // handle to file with attributes to copy
);

В случае удачи функция CreateFile возвращает описатель открытого файла как объекта ядра. Существенно, что в противном случае она возвращает не NULL, а INVALID_HANDLE_VALUE.

определить флаги GENERIC_READ и GENERIC_WRITE а так же их комбинацию

для разрешения чтения или записи в файл.
Параметр dwShareMode определяет режим совместного использования файла различными процессами. Если этот параметр равен нулю, то никакой другой поток не сможет открыть этот же файл. Флаги FILE_SHARE_READ и FILE_SHARE_WRITE а так же их комбинация разрешают другим потокам осуществлять доступ к файлу для чтения или записи.
Параметр dwCreationDistribution определяет действия функции в зависимости от того, существует ли уже файл с указанным именем.
CREATE_NEW - Создает файл, если файл существует, то ошибка.
CREATE_ALWAYS - Создает файл , если файл существует, то старый файл удаляется и новый создается.
OPEN_EXISTING - Открывает существующий файл.
OPEN_ALWAYS - Создает файл, если файл не существует, то создается новый файл.
TRUNCATE_EXISTING - Открывает файл и урезает его до нулевой длины

и задает режим работы с файлом.
FILE_ATTRIBUTE_ARCHIVE, FILE_ATTRIBUTE_HIDDEN, FILE_ATTRIBUTE_NORMAL, FILE_ATTRIBUTE_READONLY, FILE_ATTRIBUTE_SYSTEM,

FILE_ATTRIBUTE_TEMPORARY
Атрибуты файла могут комбинироваться за исключением FILE_ATTRIBUTE_NORMAL, который всегда используется в одиночестве.
Вместе с атрибутами могут комбинироваться и флаги, задающие режим работы с файлом.
FILE_FLAG_NO_BUFFERING - Не осуществлять кэширование и опережающее чтение
FILE_FLAG_RANDOM_ACCESS - Кэшировать как файл произвольного доступа
FILE_FLAG_SEQUENTIAL_SCAN - Кэшировать как файл последовательного доступа
FILE_FLAG_WRITE_TROUGH - Не буферизовать операцию записи. Производить запись на диск немедленно.
FILE_FLAG_DELETE_ON_CLOSE - Уничтожить файл при закрытии. Полезно комбинировать с атрибутом FILE_ATTRIBUTE_TEMPORARY.
FILE_FLAG_OVERLAPPED - Работа с файлом будет осуществляться асинхронно.

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

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

read
LPVOID lpBuffer, // address of buffer that receives data

DWORD nNumberOfBytesToRead,// number of bytes to read
LPDWORD lpNumberOfBytesRead,// address of number of bytes read
LPOVERLAPPED lpOverlapped // address of structure needed for // overlapped I/O
);
BOOL WriteFile(
HANDLE hFile, // handle to file to write to
LPCVOID lpBuffer, // pointer to data to write to file
DWORD nNumberOfBytesToWrite, // number of bytes to write
LPDWORD lpNumberOfBytesRead,// pointer to number of bytes written
LPOVERLAPPED lpOverlapped // address of structure needed for //overlapped I/O
);

– описатель объекта ядра “файл”, полученный в результате вызова функции

CreateFile
LpBuffer – адрес буфера, в который будет производиться чтение
nNumberOfBytesToRead – количество байт, которые необходимо прочитать
lpNumberOfBytesRead – адрес переменной, в которой будет размещено количество реально прочитанных байт. Существенно, что сразу после выполнения функции ReadFile, этот параметр не может быть установлен, так как операция чтения только началась.
lpOverlapped – указатель на структуру OVERLAPPED, управляющую асинхронным вводом выводом.
Параметры функции WriteFile () аналогичны параметрам функции ReadFile ().

*/
inhandle = CreateFile("data", GENERIC_READ, 0, NULL, OPEN_EXlSTING, 0, NULL);
outhandle

= CreateFile ("newf", GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);

/* Copy the file. */
do {
s = ReadFile(inhandle, buffer, BUF_SIZE, &count, NULL);
if (s && count > 0) WriteFile(outhandle, buffer, count, Socnt, NULL);
} while (s>0 && count>0);

/* Close the files. */
CloseHandle (inhandle):
CloseHandle (outhandle);

функции CreateFile () установить флаг FILE_FLAG_OVERLAPPED в параметре dwFlagsAndAttributes.
После

этого функции ReadFile () и WriteFile () будут работать асинхронно, т.е. только запускать операции ввода вывода и не ожидать их завершения.
В отличие от синхронных операций, при организации асинхронного чтения (записи) необходимо явно указать позицию, начиная с которой производится операция. Это связано с тем, что текущей позиции не существует, так как несколько операций чтения и записи могут производиться одновременно с разных позиций в одном файле.

завершения операции.
DWORD InternalHigh; //Используется ОС. Хранит //количество переданных байт.
DWORD Offset;

//Позиция в файле, начиная с которой //необходимо производить операцию
//чтения (записи).
DWORD OffsetHigh;//Количество байт для передачи.
HANDLE hEvent; //Описатель события, которое произойдет //при завершении операции чтения //(записи).
} OVERLAPPED;

“событие” и его описатель передается в функцию ReadFile () или

WriteFile () в качестве элемента hEvent параметра lpOverlapped.
Программа, выполнив необходимые действия одновременно с операцией передачи данных, вызывает одну из функций ожидания (например, WaitForSingleObject), передавая ей в качестве параметра описатель события.
Выполнение программы при этом приостанавливается до завершения операции ввода-вывода.

объекта выступает сам файл. Его описатель передается в функцию WaitForSingleObject

().
Этот метод прост и корректен, но не позволяет производить параллельно несколько операций ввода-вывода с одним и тем же файлом.

использовании функций ReadFileEx () и WriteFileEx (). В качестве дополнительного

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