Fungsi LZCopy (lzexpand.h)
Menyalin file sumber ke file tujuan. Jika file sumber telah dikompresi oleh algoritma Lempel-Ziv, fungsi ini membuat file tujuan yang didekompresi. Jika file sumber tidak dikompresi, fungsi ini menduplikasi file asli.
Sintaks
LONG LZCopy(
[in] INT hfSource,
[in] INT hfDest
);
Parameter
[in] hfSource
Handel ke file sumber.
[in] hfDest
Handel ke file tujuan.
Menampilkan nilai
Jika fungsi berhasil, nilai pengembalian menentukan ukuran, dalam byte, dari file tujuan.
Jika fungsi gagal, nilai yang dikembalikan adalah kode LZERROR_*. Kode-kode ini memiliki nilai kurang dari nol. Perhatikan bahwa LZCopy tidak memanggil SetLastError atau SetLastErrorEx; dengan demikian, kegagalannya tidak memengaruhi kode kesalahan terakhir utas.
Berikut ini adalah daftar kode kesalahan yang dapat dikembalikan LZCopy setelah kegagalan.
| Menampilkan kode | Deskripsi |
|---|---|
|
Handel yang mengidentifikasi file sumber tidak valid. File tidak dapat dibaca. |
|
Handel yang mengidentifikasi file tujuan tidak valid. File tidak dapat ditulis. |
|
Jumlah maksimum file terkompresi terbuka telah terlampaui atau memori lokal tidak dapat dialokasikan. |
|
Handel file LZ tidak dapat dikunci. |
|
Format file sumber tidak valid. |
Tidak ada informasi kesalahan yang diperluas untuk fungsi ini; jangan panggil GetLastError.
Keterangan
Handel yang mengidentifikasi file sumber dan tujuan harus diambil dengan memanggil fungsi LZInit atau LZOpenFile .
Jika fungsi berhasil, file yang diidentifikasi oleh parameter hfDest selalu tidak dikompresi.
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
| Teknologi | Didukung |
|---|---|
| Protokol Server Message Block (SMB) 3.0 | Ya |
| SMB 3.0 Transparent Failover (TFO) | Ya |
| SMB 3.0 dengan Scale-out File Shares (SO) | Ya |
| Sistem File Volume Bersama Kluster (CsvFS) | Ya |
| Sistem File Tangguh (ReFS) | Ya |
CsvF akan melakukan IO yang dialihkan untuk file terkompresi.
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | lzexpand.h (termasuk Windows.h) |
| Pustaka | Lz32.lib |
| DLL | Lz32.dll |