Fungsi LZSeek (lzexpand.h)

Artikel
02/28/2024

Memindahkan penunjuk file jumlah byte yang ditentukan dari posisi awal.

Sintaks

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

Parameter

[in] hFile

Handel ke file.

[in] lOffset

Jumlah byte untuk memindahkan penunjuk file.

[in] iOrigin

Posisi awal penunjuk. Parameter ini harus menjadi salah satu nilai berikut.

Nilai	Makna
0	Memindahkan byte lOffset penunjuk file dari awal file.
1	Memindahkan byte lOffset penunjuk file dari posisi saat ini.
2	Memindahkan byte lOffset penunjuk file dari akhir file.

Nilai kembali

Jika fungsi berhasil, nilai pengembalian menentukan offset dari awal file ke posisi penunjuk baru.

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

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

Menampilkan kode	Deskripsi
LZERROR_BADINHANDLE	Handel yang mengidentifikasi file sumber tidak valid. File tidak dapat dibaca.
LZERROR_BADVALUE	Salah satu parameter berada di luar rentang nilai yang dapat diterima.
LZERROR_GLOBLOCK	Handel file LZ tidak dapat dikunci.

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

Keterangan

Handel yang diidentifikasi oleh parameter hFile harus diambil dengan memanggil fungsi LZInit atau LZOpenFile .

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

Persyaratan	Nilai
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

LZInit

LZOpenFile

Bagikan melalui