Функция LZRead

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

Синтаксис

INT LZRead(
  INT hFile,       // дескриптор LZ-файла файла
  LPSTR lpBuffer,  // буфер для байтов
  INT cbRead       // итоговое число байтов
);

Параметры

hFile

[in] Дескриптор исходного файла.

lpBuffer

[in] Указатель на буфер, который получает байты, прочитанные  из файла. Убедитесь, что этот буфер является большим, чем значение параметра cbRead.

cbRead

[in] Итоговое число байтов, которое будет прочитано.

Возвращаемые значения

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

Если функция завершается ошибкой, возвращаемое значение - код LZERROR_*. Эти коды имеют значения меньшие чем нуль.

Обратите внимание! на то, что функция LZRead не вызывает ни SetLastError, ни SetLastErrorEx; поэтому, ее сбой не влияет  на код последней ошибки потока.

Ниже следует  список кодов ошибок, которые LZRead может возвратить при сбое в работе.

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

Для этой функции дополнительной информации об ошибке нет; вызов GetLastError бесполезен.

Замечания

Дескриптор, идентифицирующий файл должен извлекаться при помощи вызова или функции LZInit или LZOpenFile.

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

Смотри также 

Функции, используемые для распаковки файлов, LZInit, LZOpenFile, LZSeek

Размещение и совместимость LZRead

К

Windows XP

Да 

л

Windows 2000 Professional

Да

и

Windows NT Workstation

Да

е

Windows Me

Да

н

Windows 98

Да

т

Windows 95

Да

 
С

Windows Server 2003

Да

е Windows 2000 Server Да
р Windows NT Server Да 
в    
е    
р    

Используемая библиотека

Lz32.lib

Используемая DLL -
 Заголовочный файл  

- объявлено в

Lzexpand.h

 - включено в

Windows.h

 Unicode

Нет 

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz