LZInit 函式 (lzexpand.h)
為解壓縮檔案所需的內部資料結構配置記憶體,然後建立並初始化它們。
語法
INT LZInit(
[in] INT hfSource
);
參數
[in] hfSource
檔案的控制碼。
傳回值
如果函式成功,傳回值就是新的 LZ 檔案控制碼。
如果函式失敗,傳回值為LZERROR_* 程式碼。 這些代碼的值小於零。 請注意, LZInit 不會呼叫 SetLastError 或 SetLastErrorEx;因此,其失敗不會影響執行緒的最後一個錯誤碼。
以下是 LZInit 在失敗時可傳回的錯誤碼清單。
傳回碼 | 描述 |
---|---|
|
識別來源檔案的控制碼無效。 無法讀取檔案。 |
|
已超過開啟壓縮檔案的數目上限,或無法配置本機記憶體。 |
|
LZ 檔案控制碼無法鎖定。 |
|
檔案會使用無法辨識的壓縮演算法進行壓縮。 |
此函式沒有擴充的錯誤資訊;請勿呼叫 GetLastError。
備註
最多可以開啟 16 個壓縮檔案。 同樣地,在任何指定時間最多可以開啟 16 個未壓縮的檔案。 應用程式在使用檔案完成時,應該小心關閉 LZInit 所傳回的控制碼;否則,應用程式可能會不小心達到 16 個檔案的限制。
此函式傳回的控制碼只與 Lz32.dll 中的函式相容;它不應該用於其他檔案作業。
在 Windows 8 和 Windows Server 2012 中,下列技術支援此函式。
技術 | 支援 |
---|---|
伺服器訊息區 (SMB) 3.0 通訊協定 | 是 |
SMB 3.0 透明容錯移轉 (TFO) | 是 |
具有向外延展檔案共用的 SMB 3.0 (SO) | 是 |
叢集共用磁片區檔案系統 (CsvFS) | 是 |
彈性檔案系統 (ReFS) | 是 |
CsvF 會針對壓縮檔進行重新導向的 IO。
需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | lzexpand.h (包含 Windows.h) |
程式庫 | Lz32.lib |
Dll | Lz32.dll |