Функция LZCopy (lzexpand.h)
Копирует исходный файл в целевой файл. Если исходный файл был сжат алгоритмом Lempel-Ziv, эта функция создает распакованный целевой файл. Если исходный файл не сжимается, эта функция дублирует исходный файл.
Синтаксис
LONG LZCopy(
[in] INT hfSource,
[in] INT hfDest
);
Параметры
[in] hfSource
Дескриптор исходного файла.
[in] hfDest
Дескриптор целевого файла.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение указывает размер целевого файла в байтах.
Если функция завершается сбоем, возвращаемым значением является код LZERROR_*. Эти коды имеют значения меньше нуля. Обратите внимание, что LZCopy не вызывает ни SetLastError, ни SetLastErrorEx; таким образом, его сбой не влияет на код последней ошибки потока.
Ниже приведен список кодов ошибок, которые LZCopy может возвращать при сбое.
| Код возврата | Описание |
|---|---|
|
Недопустимый дескриптор, определяющий исходный файл. Не удается прочитать файл. |
|
Недопустимый дескриптор, определяющий целевой файл. Невозможно записать файл. |
|
Превышено максимальное количество открытых сжатых файлов или не удается выделить локальную память. |
|
Дескриптор файла LZ не может быть заблокирован. |
|
Недопустимый формат исходного файла. |
Для этой функции нет расширенных сведений об ошибке; не вызывать GetLastError.
Комментарии
Дескриптора, идентифицирующие исходные и целевые файлы, должны быть получены путем вызова функции LZInit или LZOpenFile .
Если функция выполняется успешно, файл, определенный параметром hfDest , всегда будет несжат.
В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.
| Технология | Поддерживается |
|---|---|
| Протокол SMB 3.0 | Да |
| Прозрачная отработка отказа (TFO) SMB 3.0 | Да |
| SMB 3.0 с масштабируемыми общими папками (SO) | Да |
| Файловая система общего тома кластера (CSVFS) | Да |
| Восстанавливаемая файловая система (ReFS) | Да |
CsvFs выполняет перенаправление операций ввода-вывода для сжатых файлов.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | lzexpand.h (включая Windows.h) |
| Библиотека | Lz32.lib |
| DLL | Lz32.dll |