LZOpenFileW

指定したファイルを作成・オープン・再オープン・削除する。(Unicode)

LZOpenFileW lpFileName, lpReOpenBuf, wStyle

lpFileName : [wstr] ファイルの名前。
lpReOpenBuf : [var] ファイルが最初に開かれた際の情報を受け取る OFSTRUCT 構造体へのポインタ。この構造体は、開かれたファイルを参照するため、後続の LZOpenFile 関数呼び出しで使用できる。この構造体の szPathName メンバには、OEM (original equipment manufacturer) 文字セットの文字が格納される。
wStyle : [int] 

(プラグイン / モジュール : kernel32.dll)

解説

指定したファイルを作成・オープン・再オープン・削除する。(Unicode)

[戻り値]
関数が成功し、wStyle 引数で指定された値が OF_READ
でない場合、戻り値はファイルを識別するハンドルである。ファイルが圧縮されており wStyle に OF_READ
を指定して開いた場合、戻り値は特殊なファイルハンドルである。関数が失敗した場合、戻り値は LZERROR_*
コードであり、これらのコードは負の値を持つ。この関数には拡張エラー情報はなく、GetLastError を呼んではならない。注:
LZOpenFile は SetLastError も SetLastErrorEx
も呼び出さないため、失敗してもスレッドの最終エラーコードには影響しない。以下は LZOpenFile
が失敗時に返すエラーコードの一覧である。
（以下省略）

[備考]
wStyle 引数が OF_READ フラグ（または OF_READ と任意の OF_SHARE_*
フラグの組み合わせ）で、ファイルが圧縮されている場合、LZOpenFile は LZInit
関数を呼び出し、展開処理に必要な初期化を行う。この関数が返すハンドルは Lz32.dll
の関数とのみ互換性があり、他のファイル操作に用いてはならない。LZOpenFile が lpFileName
で指定されたファイルを開けなかった場合、Windows の一部のバージョンでは、最後の文字をアンダースコア ("_")
に置換したほぼ同じファイル名のファイルを開こうとする。すなわち "MyProgram.exe"
を開くのに失敗した場合、LZOpenFile は "MyProgram.ex_"
を開こうとする。インストールパッケージはしばしば、ファイルが圧縮されていることを示すために拡張子の最後の文字をアンダースコアに置き換える。例えば、圧縮された
"MyProgram.exe" は "MyProgram.ex_"
と命名されることがある。実際に開かれたファイル（存在すれば）の名前を知るには、lpReOpenBuf 引数の OFSTRUCT 構造体の
szPathName メンバを確認する。Windows 8 および Windows Server 2012
では、この関数は次のテクノロジによってサポートされる。
（以下省略）

情報