_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
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

SetFilePointer