Функция LZSeek

Функция  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-файла не может быть блокирован до конца.

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

Замечания

Дескриптор, идентифицированный в параметре 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

Нет 

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz