共用方式為

LZOpenFileW 函式 （lzexpand.h）

  • 發行項

建立、開啟、重新開啟或刪除指定的檔案。

語法

INT LZOpenFileW(
  [in]  LPWSTR     lpFileName,
  [out] LPOFSTRUCT lpReOpenBuf,
  [in]  WORD       wStyle
);

參數

[in] lpFileName

檔名。

[out] lpReOpenBuf

第一次開啟檔案時，OFSTRUCT 結構的指標，用來接收檔案的相關信息。 結構可用於後續呼叫 LZOpenFile 函式，以查看開啟的檔案。

此結構 szPathName 成員包含原始設備製造商 （OEM） 字元集的字元。

[in] wStyle

要採取的動作。 此參數可以是下列其中一或多個值。

價值 意義
OF_CANCEL
0x0800
 忽視。 僅針對與16位 Windows 的相容性提供。 使用 OF_PROMPT 樣式來顯示對話方塊，其中包含 [取消] 按鈕 。
OF_CREATE
0x1000
 指示 LZOpenFile 來建立新的檔案。 如果檔案已經存在，則會截斷為零長度。
OF_DELETE
0x0200
 刪除檔案。
OF_EXIST
0x4000
 開啟檔案，然後關閉它以測試檔案是否存在。
OF_PARSE
0x0100
 填入 OFSTRUCT 結構 ，但不會執行其他動作。
OF_PROMPT
0x2000
 如果要求的檔案不存在，則顯示對話方塊。 對話框會通知用戶系統找不到檔案，而且它包含 [重試] 和 [取消] 按鈕 。 單擊 [取消] 按鈕會指示 LZOpenFile 傳回找不到的檔案錯誤訊息。
OF_READ
0x0000
 開啟檔案以供讀取。
OF_READWRITE
0x0002
 開啟檔案以供讀取和寫入。
OF_REOPEN
0x8000
 使用重新開啟緩衝區中的資訊開啟檔案。
OF_SHARE_DENY_NONE
0x0040
 開啟檔案，而不拒絕其他進程讀取或寫入檔案的存取權。 如果檔案已由任何其他進程以相容性模式開啟，LZOpenFile 會失敗。
OF_SHARE_DENY_READ
0x0030
 開啟檔案，並拒絕其他進程讀取檔案的存取權。 LZOpenFile 如果檔案已以相容性模式開啟，或已開啟供任何其他進程讀取存取，則失敗。
OF_SHARE_DENY_WRITE
0x0020
 開啟檔案，並拒絕其他進程寫入檔案的存取權。 LZOpenFile 如果檔案已在相容性模式中開啟，或已由任何其他進程開啟以進行寫入存取，則失敗。
OF_SHARE_EXCLUSIVE
0x0010
 以獨佔模式開啟檔案，拒絕對檔案進行讀取和寫入存取的其他進程。 LZOpenFile 如果檔案已以任何其他模式開啟以進行讀取或寫入存取，即使目前進程也失敗。
OF_WRITE
0x0001
 開啟檔案以便只寫入。

傳回值

如果函式成功，且 wStyle 參數所指定的值並未 OF_READ，則傳回值是識別檔案的句柄。 如果檔案已壓縮並開啟，且 wStyle 設定為 OF_READ，則傳回值是特殊的檔案句柄。

如果函式失敗，傳回值是 LZERROR_* 程式代碼。 這些程式代碼的值小於零。 此函式沒有擴充的錯誤資訊;請勿呼叫 getLastError 。

NoteLZOpenFile不會呼叫 setLastError 或 SetLastErrorEx;因此，其失敗不會影響線程的最後一個錯誤碼。
 
以下是 LZOpenFile 失敗時可能會傳回的錯誤碼清單。
傳回碼/值 描述
LZERROR_BADINHANDLE
-1
 識別來源檔案的句柄無效。 無法讀取檔案。
LZERROR_GLOBALLOC
-5
 已超過開啟的壓縮檔案數目上限，或無法配置本機記憶體。

言論

如果 wStyle 參數是 OF_READ 旗標（或 OF_READ 和任何 OF_SHARE_* 旗標），而且檔案會壓縮，LZOpenFile 會呼叫 LZInit 函式，這會執行解壓縮作業所需的初始化。

此函式傳回的句柄只與 Lz32.dll中的函式相容;它不應該用於其他檔案作業。

如果 LZOpenFile 無法開啟 lpFileName所指定的檔案，則在某些 Windows 版本上，它會嘗試以幾乎相同的檔名開啟檔案，但最後一個字元會取代為底線 （“_” ）。 因此，如果嘗試開啟 「MyProgram.exe」 失敗，LZOpenFile 嘗試開啟 「MyProgram.ex_」。 安裝套件通常會以底線取代擴展名的最後一個字母，以指出檔案已壓縮。 例如，“MyProgram.exe”compressed 可能命名為 “MyProgram.ex_”。 若要判斷開啟的檔名（如果有的話），請檢查 lpReOpenBuf 參數中 OFSTRUCT 結構 成員 szPathName。

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

科技 支援
伺服器消息塊 （SMB） 3.0 通訊協定 是的
SMB 3.0 透明故障轉移 （TFO） 是的
具有向外延展檔案共用的SMB 3.0（SO） 是的
叢集共用磁碟區檔案系統 （CsvFS） 是的
復原檔案系統 （ReFS） 是的
 

Csv 會針對壓縮檔執行重新導向的 IO。

注意

lzexpand.h 標頭會根據 UNICODE 預處理器常數的定義，將 LZOpenFile 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 lzexpand.h （包括 Windows.h）
連結庫 Lz32.lib
DLL Lz32.dll

另請參閱

檔案壓縮和解壓縮

檔案管理功能

LZClose

LZInit

LZRead

OFSTRUCT