Fungsi LZRead (lzexpand.h)
Membaca (paling banyak) jumlah byte yang ditentukan dari file dan menyalinnya ke dalam buffer.
Sintaks
INT LZRead(
[in] INT hFile,
[out] CHAR *lpBuffer,
[in] INT cbRead
);
Parameter
[in] hFile
Handel ke file.
[out] lpBuffer
Penunjuk ke buffer yang menerima byte yang dibaca dari file. Pastikan buffer ini lebih besar dari cbRead.
[in] cbRead
Jumlah byte yang akan dibaca.
Menampilkan nilai
Jika fungsi berhasil, nilai pengembalian menentukan jumlah byte yang dibaca.
Jika fungsi gagal, nilai yang dikembalikan adalah kode LZERROR_*. Kode-kode ini memiliki nilai kurang dari nol. Perhatikan bahwa LZRead tidak memanggil SetLastError atau SetLastErrorEx; dengan demikian, kegagalannya tidak memengaruhi kode kesalahan terakhir utas.
Berikut ini adalah daftar kode kesalahan yang dapat dikembalikan LZRead 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. |
|
Salah satu parameter input tidak valid. |
|
Jumlah maksimum file terkompresi terbuka telah terlampaui atau memori lokal tidak dapat dialokasikan. |
|
Handel file LZ tidak dapat dikunci. |
|
Format file sumber tidak valid. |
|
Ruang untuk file output tidak cukup. |
Tidak ada informasi kesalahan yang diperluas untuk fungsi ini; jangan panggil GetLastError.
Keterangan
Handel yang mengidentifikasi file harus diambil dengan memanggil fungsi LZInit atau LZOpenFile .
Jika file dikompresi, LZRead beroperasi pada gambar file yang diperluas dan menyalin byte data ke dalam buffer yang ditentukan.
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 |