_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 を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

SetFilePointer