Функция LZInit

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

Синтаксис

 INT LZInit(
  INT hfSource   // дескриптор источникового файла
);

Параметры

hfSource

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

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

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

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

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

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

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

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

Замечания

В какой-то определенный момент могут быть открытыми максимум 16 сжатых файлов. Точно так же, в какой-то определенный момент могут быть открытыми максимум 16  разархивированных файлов. Приложение должно быть осторожным при закрытии дескриптора, возвращенного LZInit, когда оно использует этот файл; в противном случае прикладная программа может нечаянно нарушить 16-файловое ограничение.

Дескриптор,  возвращенный этой функцией, совместим только с функциями в LzExpand.dll; он не должен использоваться для других файловых операций.

Смотри также 

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

 

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

К

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