Fungsi LZRead (lzexpand.h)

Artikel
08/24/2023

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
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_BADVALUE	Salah satu parameter input tidak valid.
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.
LZERROR_WRITE	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