_llseek関数 (winbase.h)

[この関数は、16 ビットバージョンの Windows との互換性のために提供されます。新しいアプリケーションでは SetFilePointer 関数を使用する必要があります。]

指定したファイルのファイルポインターの位置を変更します。

構文

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

hFile

開いているファイルへのハンドル。このハンドルは、_lcreatによって作成されます。

lOffset

ファイルポインターを移動するバイト数。

iOrigin

ポインターを移動する開始点と方向。

このパラメーターは、次のいずれかの値に設定する必要があります。

関数が成功した場合、戻り値は新しいオフセットを指定します。それ以外の場合、戻り値はHFILE_ERROR。拡張エラー情報を取得するには、 GetLastError 関数を使用します。

ファイルが最初に開かれると、ファイルポインターはファイルの先頭に設定されます。 _llseek関数は、データを読み取らずにポインターを移動します。これにより、ファイルのコンテンツにランダムにアクセスできます。