Функция 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 | Формат исходного файла не допустим. |
Замечания
Дескрипторы, идентифицирующие исходные и целевые файлы должны извлекаться при помощи вызова функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |