Функция LZCopy


Функция LZCopy копирует исходный файл в принимающий файл. Если исходный файл сжимался алгоритмом Лемпель-Зива, эта функция создает распакованный принимающий файл. Если исходный файл не сжат, эта функция делает копию первоначального файла.

Синтаксис

LONG LZCopy(
  INT hfSource,  // дескриптор источникового LZ-файла
  INT hfDest     // дескриптор принимающего LZ-файла
);

Параметры

hfSource

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

hfDest

[in] Дескриптор принимающего файла.

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

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

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

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

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

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

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

Замечания

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

Если функция завершается успешно, файл, идентифицированный параметром hfDest всегда распаковывается.

Смотри также 

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

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

К

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

Нет

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

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки
18.03.2004 15:44 ©Copyright V. Sokovikov
Hosted by uCoz