Fungsi LZInit (lzexpand.h)
Mengalokasikan memori untuk struktur data internal yang diperlukan untuk mendekompresi file, lalu membuat dan menginisialisasinya.
INT LZInit(
[in] INT hfSource
);
[in] hfSource
Handel ke file.
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 |
---|---|
|
Handel yang mengidentifikasi file sumber tidak valid. File tidak dapat dibaca. |
|
Jumlah maksimum file terkompresi terbuka telah terlampaui atau memori lokal tidak dapat dialokasikan. |
|
Handel file LZ tidak dapat dikunci. |
|
File dikompresi dengan algoritma kompresi yang tidak dikenal. |
Tidak ada informasi kesalahan yang diperluas untuk fungsi ini; jangan panggil GetLastError.
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.
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 |