функция _llseek (winbase.h)

[Эта функция предоставляется для совместимости с 16-разрядными версиями Windows. Новые приложения должны использовать функцию SetFilePointer .]

Перемещает указатель на указанный файл.

Синтаксис

LONG _llseek(
  HFILE hFile,
  LONG  lOffset,
  int   iOrigin
);

Параметры

hFile

Дескриптор открытого файла. Этот дескриптор создается _lcreat.

lOffset

Количество байтов, в которых должен быть перемещен указатель на файл.

iOrigin

Начальная точка и направление перемещения указателя.

Для этого параметра необходимо задать одно из следующих значений.

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

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

Если функция выполняется успешно, возвращаемое значение указывает новое смещение. В противном случае возвращаемое значение будет HFILE_ERROR. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .

Комментарии

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

Требования

Требование	Значение
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

SetFilePointer