LZCopy 関数 (lzexpand.h)

ソースファイルをコピー先ファイルにコピーします。ソースファイルが Lempel-Ziv アルゴリズムによって圧縮されている場合、この関数は圧縮解除されたコピー先ファイルを作成します。ソースファイルが圧縮されていない場合、この関数は元のファイルを複製します。

構文

LONG LZCopy(
  [in] INT hfSource,
  [in] INT hfDest
);

[in] hfSource

ソースファイルへのハンドル。

[in] hfDest

コピー先ファイルのハンドル。

関数が成功した場合、戻り値はコピー先ファイルのサイズ (バイト単位) を指定します。

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

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

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

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

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

関数が成功すると、 hfDest パラメーターで識別されるファイルは常に圧縮解除されます。

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