Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 |
|---|---|
|
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.
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 |