На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

LZRead



The LZRead function reads (at most) the specified number of bytes from a file and copies them into a buffer.

INT LZRead(

INT hFile, // LZ file handle of file
LPSTR lpBuffer, // address of buffer for bytes
INT cbRead // count of bytes
);


Parameters

hFile

Identifies the source file.

lpBuffer

Points to a buffer that receives the bytes read from the file.

cbRead

Specifies the count of bytes to be read.



Return Values

If the function succeeds, the return value specifies the number of bytes read.
If the function fails, the return value is an LZERROR_* code. These codes have values less than zero. Note that LZRead calls neither SetLastError nor SetLastErrorEx; thus, its failure does not affect a thread's last-error code.
Here is a list of the LZERROR_* codes that LZRead can return upon failure:

Value Meaning
LZERROR_BADINHANDLE The handle identifying the source file is not valid. The file cannot be read.
LZERROR_BADOUTHANDLE The handle identifying the destination file is not valid. The file cannot be written.
LZERROR_BADVALUE One of the input parameters is not valid.
LZERROR_GLOBALLOC The maximum number of open compressed files has been exceeded or local memory cannot be allocated.
LZERROR_GLOBLOCK The LZ file handle cannot be locked down.
LZERROR_READ The source file format is not valid.
LZERROR_WRITE There is insufficient space for the output file.


Remarks

The handle identifying the file must be retrieved by calling either the LZInit or LZOpenFile function.
If the file is compressed, LZRead emulates the _lread function on an expanded image of the file and copies the bytes of data into the specified buffer.
Applications must call the LZOpenFile, LZSeek, and LZRead functions instead of the OpenFile, _llseek, and _lread functions.

See Also

LZInit, LZOpenFile, LZSeek


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

LZRead



Функция LZRead читает (самое большее) определенное количество байтов из файла и копирует их в буфер.

INT LZRead(

INT hFile, // ФАЙЛОВАЯ ручка LZ файла LPSTR lpBuffer, // адреса буфера для счета байтов INT cbRead // байтов
);


Параметры

hFile

Идентифицирует исходный файл.

lpBuffer

Точки на буфер, которые получают байты прочитанные из файла.

cbRead

Определяет счет байтов, которые нужно быть прочитаны.



Обратные Величины

Если функция добивается успеха, обратная величина определяет количество прочитанных байтов.
Если функция терпит неудачу, обратная величина - LZERROR_* код. Эти коды имеют величины менее чем нуль. Отметьте, что LZRead называет ни SetLastError ни SetLastErrorEx; таким образом, неудача не влияет на заправлять последняя ошибка кода.
Вот список LZERROR_* коды, что LZRead может возвращаться в неудачу:

Значение Величины
LZERROR_BADINHANDLE ручка, опознающая исходный файл недействительна. Файл не может быть прочитан.
LZERROR_BADOUTHANDLE ручка, опознающая файл расположения недействительна. Файл не может быть написан.
LZERROR_BADVALUE Один из входных параметров недействителен.
LZERROR_GLOBALLOC максимальное количество открытых сжатых файлов превышено или локальная память не может быть распределена.
LZERROR_GLOBLOCK файловая ручка LZ не может запираться вниз.
LZERROR_READ исходный файловый формат недействителен.
LZERROR_WRITE Есть недостаточное пространство для выходного файла.


Замечания

Ручка, опознающая файл должна быть извлечена вызовом или LZInit или функция LZOpenFile.
Если файл сжат, LZRead эмулирует _lread функция в расширенном образе файла и копирует байты данных в определенный буфер.
Приложения должны назвать LZOpenFile, LZSeek, и функции LZRead вместо OpenFile, _llseek, и _lread функции.

Смотри Также

LZInit, LZOpenFile, LZSeek


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz