Функция LZSeek перемещает указатель файла на определенное число байтов от стартового положения.
Синтаксис
LONG LZSeek( INT hFile, // дескриптор исходного файла LONG lOffset, // перемещаемое число байтов INT iOrigin // стартовая позиция ); |
Параметры
hFile
[in] Дескриптор исходного файла.lOffset
[in] Число байтов, на которое переместиться указатель позиции в файле.iOrigin
[in] Начальная позиция указателя. Этим параметром должно быть одно из ниже перечисленных значений.
| Значение | Предназначение |
|---|---|
| 0 | Перемещает указатель позиции в файле на lOffset байтов от начала файла. |
| 1 | Перемещает указатель позиции в файле на lOffset байтов от текущей позиции. |
| 2 | Перемещает указатель позиции в файле на lOffset байтов от конца файла. |
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение устанавливает смещение от начала файла до новой позиции указателя.
Если функция завершается ошибкой, возвращаемое значение - код LZERROR_*. Эти коды имеют значения меньшие чем нуль.
|
Обратите внимание! на то, что функция LZSeek не вызывает ни SetLastError, ни SetLastErrorEx; поэтому, ее сбой не влияет на код последней ошибки потока. |
Ниже следует список кодов ошибок, которые LZSeek может возвратить при сбое в работе.
| Значение | Предназначение |
|---|---|
| LZERROR_BADINHANDLE | Дескриптор, идентифицирующий исходный файл, не допустим. Файл не может читаться. |
| LZERROR_BADVALUE | Один из параметров вне диапазона допустимых значений. |
| LZERROR_GLOBLOCK | Дескриптор LZ-файла не может быть блокирован до конца. |
Замечания
Дескриптор, идентифицированный в параметре hFile, должен извлекаться при помощи вызова или функции LZInit или LZOpenFile.
Смотри также
Функции, используемые для распаковки файлов, LZInit, LZOpenFile
|
Размещение и совместимость LZSeek |
||
| К |
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 |
Нет |
|
| Замечания по платформе |
Не имеется |
|