Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |