Share via

Fungsi LZCopy (lzexpand.h)

  • Artikel

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
LZERROR_BADINHANDLE
 Handel yang mengidentifikasi file sumber tidak valid. File tidak dapat dibaca.
LZERROR_BADOUTHANDLE
 Handel yang mengidentifikasi file tujuan tidak valid. File tidak dapat ditulis.
LZERROR_GLOBALLOC
 Jumlah maksimum file terkompresi terbuka telah terlampaui atau memori lokal tidak dapat dialokasikan.
LZERROR_GLOBLOCK
 Handel file LZ tidak dapat dikunci.
LZERROR_READ
 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

Lihat juga

Kompresi dan Dekompresi File

Fungsi Manajemen File

LZInit

LZOpenFile