Поделиться через

Функция LZSeek (lzexpand.h)

  • Статья

Перемещает указатель файла на указанное количество байтов из начальной позиции.

Синтаксис

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

Параметры

[in] hFile

Дескриптор файла.

[in] lOffset

Число байтов, на которое перемещается указатель на файл.

[in] iOrigin

Начальная позиция указателя. Этот параметр должен иметь одно из следующих значений.

Значение Значение
0
 Перемещает указатель файла lOffset байт от начала файла.
1
 Перемещает указатель файла lOffset байт из текущей позиции.
2
 Перемещает указатель файла lOffset байт из конца файла.

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

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

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

Ниже приведен список кодов ошибок, которые LZSeek может возвращать при сбое.

Код возврата Описание
LZERROR_BADINHANDLE
 Недопустимый дескриптор, определяющий исходный файл. Не удается прочитать файл.
LZERROR_BADVALUE
 Один из параметров выходит за пределы диапазона допустимых значений.
LZERROR_GLOBLOCK
 Дескриптор файла LZ не может быть заблокирован.
 

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

Комментарии

Дескриптор, определенный параметром hFile, должен быть получен путем вызова функции LZInit или LZOpenFile .

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология Поддерживается
Протокол SMB 3.0 Да
SMB 3.0 Transparent Failover (TFO) Да
SMB 3.0 с масштабируемыми общими папками (SO) Да
Файловая система общего тома кластера (CSVFS) Да
Восстанавливаемая файловая система (ReFS) Да
 

CsvFs выполняет перенаправление операций ввода-вывода для сжатых файлов.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header lzexpand.h (включая Windows.h)
Библиотека Lz32.lib
DLL Lz32.dll

См. также раздел

Сжатие и распаковка файлов

Функции управления файлами

LZInit

LZOpenFile