LZRead 関数 (lzexpand.h)

指定したバイト数 (最大) をファイルから読み取り、バッファーにコピーします。

構文

INT LZRead(
  [in]  INT  hFile,
  [out] CHAR *lpBuffer,
  [in]  INT  cbRead
);

[in] hFile

ファイルへのハンドル。

[out] lpBuffer

ファイルから読み取られたバイトを受け取るバッファーへのポインター。このバッファーが cbRead より大きくなるようにします。

[in] cbRead

読み取るバイト数。

関数が成功した場合、戻り値は読み取られたバイト数を指定します。

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

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

リターンコード	説明
LZERROR_BADINHANDLE	ソースファイルを識別するハンドルが無効です。ファイルを読み取ることができません。
LZERROR_BADOUTHANDLE	宛先ファイルを識別するハンドルが無効です。ファイルを書き込むことができません。
LZERROR_BADVALUE	入力パラメーターの 1 つが無効です。
LZERROR_GLOBALLOC	開いている圧縮ファイルの最大数を超えているか、ローカルメモリを割り当てることができません。
LZERROR_GLOBLOCK	LZ ファイルハンドルをロックダウンすることはできません。
LZERROR_READ	ソースファイルの形式が無効です。
LZERROR_WRITE	出力ファイルの領域が不足しています。

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

ファイルを識別するハンドルは、 LZInit 関数または LZOpenFile 関数を呼び出して取得する必要があります。

ファイルが圧縮されている場合、 LZRead はファイルの展開されたイメージに対して動作し、指定されたバッファーにデータのバイトをコピーします。

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 が実行されます。