LZSeek 函式 (lzexpand.h)
將檔案指標從起始位置移動指定的位元元組數目。
語法
LONG LZSeek(
[in] INT hFile,
[in] LONG lOffset,
[in] INT iOrigin
);
參數
[in] hFile
檔案的句柄。
[in] lOffset
要移動檔案指標的位元元組數目。
[in] iOrigin
指標的起始位置。 此參數必須是下列其中一個值。
| 值 | 意義 |
|---|---|
|
從檔案開頭移動檔案指標 lOffset 位元組。 |
|
將檔案指標 lOffset 位元組從目前位置移動。 |
|
從檔案結尾移動檔案指標 lOffset 位元組。 |
傳回值
如果函式成功，傳回值會指定從檔案開頭到新指標位置的位移。
如果函式失敗，傳回值為LZERROR_* 程序代碼。 這些代碼的值小於零。 請注意， LZSeek 不會呼叫 SetLastError 或 SetLastErrorEx;因此，其失敗不會影響線程的最後一個錯誤碼。
以下是 LZSeek 在失敗時可傳回的錯誤碼清單。
| 傳回碼 | Description |
|---|---|
|
識別來源檔案的句柄無效。 無法讀取檔案。 |
|
其中一個參數超出可接受的值範圍。 |
|
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 |