Lpoverlapped lpoverlapped)

LPDWORD lpNumberOfBytesWritten,

DWORD nNumberOfBytesToWrite,

LPCVOID lpBuffer,

HANDLE hFile,

BOOL WritedFile (

Запись в файл

Параметры

LPOVERLAPPED lpOverlapped)

LPDWORD lpNumberOfBytesRead,

DWORD nNumberOfBytesToRead,

LPVOID lpBuffer,

HANDLE hFile,

BOOL ReadFile (

Чтение файла

Чтение файла выполняется с помощью следующей функции:

Возвращаемое значение: в случае успешного выполнения (которое считается таковым, даже если не был считан ни один байт из-за попытки чтения с выходом за пределы файла) – TRUE, иначе – FALSE.

Пока мы будем предполагать, что дескрипторы файлов создаются безуказания флага перекрывающегося ввода/вывода FILE_FLAG_OVERLAPPED в параметре dwAttrsAndFlags. В этом случае функция ReadFile начинает чтение с текущей позиции указателя файла, и указатель файла сдвигается на число считанных байтов.

Если значения дескриптора файла или иных параметров, используемых при вызове функции, оказались недействительными, возникает ошибка, и функция возвращает значение FALSE. Попытка выполнения чтения в ситуациях, когда указатель файла позиционирован в конце файла, не приводит к ошибке; вместо этого количество считанных байтов (*lpNumberOfBytesRead) устанавливается равным 0.

Описательные имена переменных и естественный порядок расположения параметров во многом говорят сами за себя. Тем не менее, ниже приводятся некоторые краткие пояснения.

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

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

lpOverlapped – указатель на структуру OVERLAPPED. На данном этапе просто устанавливайте значение этого параметра равным NULL.

Запись в файл выполняется с помощью следующей функции:

Возвращаемое значение: в случае успешного выполнения – TRUE, иначе – FALSE.

Все параметры этой функции вам уже знакомы. Заметьте, что успешное выполнение записи еще не говорит о том, что данные действительно оказались записанными на диск, если только при создании файла с помощью функции СгеateFile не был использован флаг FILE_FLAG_WRITE_THROUGH. Если во время вызова функции указатель файла был позиционирован в конце файла, Windows увеличит длину существующего файла.

Функции ReadFileGather и WriteFileGather позволяют выполнять операции чтения и записи с использованием набора буферов различного размера.

Дата добавления: 2014-12-16