LZSeek 関数 (lzexpand.h)

開始位置から指定したバイト数だけファイルポインターを移動します。

構文

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

[in] hFile

ファイルへのハンドル。

[in] lOffset

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

[in] iOrigin

ポインターの開始位置。このパラメーターには次のいずれかの値を指定する必要があります。

値	意味
0	ファイルポインター lOffset バイトをファイルの先頭から移動します。
1	ファイルポインター lOffset バイトを現在の位置から移動します。
2	ファイルポインター lOffset バイトをファイルの末尾から移動します。

関数が成功した場合、戻り値はファイルの先頭から新しいポインター位置までのオフセットを指定します。

関数が失敗した場合、戻り値はLZERROR_* コードです。これらのコードの値は 0 未満です。 LZSeek は SetLastError も SetLastErrorEx も呼び出しません。したがって、そのエラーはスレッドの最後のエラーコードには影響しません。

エラー時に LZSeek が返すことができるエラーコードの一覧を次に示します。

リターンコード	説明
LZERROR_BADINHANDLE	ソースファイルを識別するハンドルが無効です。ファイルを読み取ることができません。
LZERROR_BADVALUE	パラメーターの 1 つが、許容される値の範囲外です。
LZERROR_GLOBLOCK	LZ ファイルハンドルをロックダウンすることはできません。

この関数の拡張エラー情報はありません。 GetLastError を呼び出さないでください。

hFile パラメーターで識別されるハンドルは、LZInit 関数または LZOpenFile 関数を呼び出して取得する必要があります。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

テクノロジ	サポートされています
サーバーメッセージブロック (SMB) 3.0 プロトコル	はい
SMB 3.0 Transparent Failover (TFO)	はい
スケールアウトファイル共有 (SO) を使う SMB 3.0	はい
クラスターの共有ボリュームファイルシステム (CsvFS)	はい
Resilient File System (ReFS)	はい

CsvFs によって、圧縮されたファイルのリダイレクトされた IO が実行されます。