Share via

Fungsi LZInit (lzexpand.h)

  • Artikel

Mengalokasikan memori untuk struktur data internal yang diperlukan untuk mendekompresi file, lalu membuat dan menginisialisasinya.

Sintaks

INT LZInit(
  [in] INT hfSource
);

Parameter

[in] hfSource

Handel ke file.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel file LZ baru.

Jika fungsi gagal, nilai yang dikembalikan adalah kode LZERROR_*. Kode-kode ini memiliki nilai kurang dari nol. Perhatikan bahwa LZInit tidak memanggil SetLastError maupun SetLastErrorEx; dengan demikian, kegagalannya tidak memengaruhi kode kesalahan terakhir utas.

Berikut ini adalah daftar kode kesalahan yang dapat dikembalikan LZInit setelah kegagalan.

Menampilkan kode Deskripsi
LZERROR_BADINHANDLE
 Handel yang mengidentifikasi file sumber tidak valid. File tidak dapat dibaca.
LZERROR_GLOBALLOC
 Jumlah maksimum file terkompresi terbuka telah terlampaui atau memori lokal tidak dapat dialokasikan.
LZERROR_GLOBLOCK
 Handel file LZ tidak dapat dikunci.
LZERROR_UNKNOWNALG
 File dikompresi dengan algoritma kompresi yang tidak dikenal.
 

Tidak ada informasi kesalahan yang diperluas untuk fungsi ini; jangan panggil GetLastError.

Keterangan

Maksimal 16 file terkompresi dapat dibuka pada waktu tertentu. Demikian pula, maksimum 16 file yang tidak dikompresi dapat dibuka pada waktu tertentu. Aplikasi harus berhati-hati untuk menutup handel yang dikembalikan oleh LZInit ketika selesai menggunakan file; jika tidak, aplikasi secara tidak sengaja dapat mencapai batas 16 file.

Menangani pengembalian fungsi ini hanya kompatibel dengan fungsi dalam Lz32.dll; tidak boleh digunakan untuk operasi file lainnya.

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