LZSeek 函式 (lzexpand.h)

  • 發行項

將檔案指標從起始位置移動指定的位元元組數目。

語法

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

參數

[in] hFile

檔案的句柄。

[in] lOffset

要移動檔案指標的位元元組數目。

[in] iOrigin

指標的起始位置。 此參數必須是下列其中一個值。

值 意義
0
 從檔案開頭移動檔案指標 lOffset 位元組。
1
 將檔案指標 lOffset 位元組從目前位置移動。
2
 從檔案結尾移動檔案指標 lOffset 位元組。

傳回值

如果函式成功，傳回值會指定從檔案開頭到新指標位置的位移。

如果函式失敗，傳回值為LZERROR_* 程序代碼。 這些代碼的值小於零。 請注意， LZSeek 不會呼叫 SetLastError 或 SetLastErrorEx;因此，其失敗不會影響線程的最後一個錯誤碼。

以下是 LZSeek 在失敗時可傳回的錯誤碼清單。

傳回碼 Description
LZERROR_BADINHANDLE
 識別來源檔案的句柄無效。 無法讀取檔案。
LZERROR_BADVALUE
 其中一個參數超出可接受的值範圍。
LZERROR_GLOBLOCK
 LZ 檔案句柄無法鎖定。
 

此函式沒有擴充的錯誤資訊;請勿呼叫 GetLastError。

備註

由 hFile 參數識別的句柄必須藉由呼叫 LZInit 或 LZOpenFile 函式來擷取。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 Yes
SMB 3.0 透明故障轉移 (TFO) Yes
具有向外延展檔案共用的SMB 3.0 (SO) Yes
叢集共用磁碟區文件系統 (CsvFS) Yes
彈性檔案系統 (ReFS) Yes
 

CsvF 會針對壓縮檔進行重新導向的 IO。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 lzexpand.h (包含 Windows.h)
程式庫 Lz32.lib
Dll Lz32.dll

另請參閱

檔案壓縮和解壓縮

檔案管理功能

LZInit

LZOpenFile