VerInstallFileW

VerFindFile 関数から返された情報に基づいて、指定されたファイルをインストールする。VerInstallFile は必要に応じてファイルを展開し、一意のファイル名を割り当て、古いファイルなどのエラーをチェックする。(Unicode)

VerInstallFileW uFlags, szSrcFileName, szDestFileName, szSrcDir, szDestDir, szCurDir, szTmpFile, puTmpFileLen

uFlags : [int] 型: DWORD
szSrcFileName : [wstr] 型: LPCTSTR インストールするファイルの名前。これは szSrcDir パラメータが指すディレクトリ内のファイル名であり、ファイル名と拡張子のみを含めることができる（パスを含めてはならない）。
szDestFileName : [wstr] 型: LPCTSTR インストール時に VerInstallFile が新しいファイルに付ける名前。このファイル名は szSrcFileName のディレクトリにあるファイル名と異なっていてもよい。新しい名前にはファイル名と拡張子のみを含め、パスを含めてはならない。
szSrcDir : [wstr] 型: LPCTSTR ファイルが見つかるディレクトリの名前。
szDestDir : [wstr] 型: LPCTSTR ファイルをインストールすべきディレクトリの名前。VerFindFile はこの値を szDestDir パラメータに返す。
szCurDir : [wstr] 型: LPCTSTR このファイルの既存バージョンが見つかったディレクトリの名前。VerFindFile はこの値を szCurDir パラメータに返す。
szTmpFile : [wstr] 型: LPTSTR ソースファイルの一時的なコピーの名前。バッファは少なくとも _MAX_PATH 文字以上の長さを持つことが望ましいが必須ではなく、入力時には空にしておく必要がある。
puTmpFileLen : [var] 型: PUINT szTmpFile バッファの長さ。このポインタは NULL であってはならない。関数が戻ったとき、lpuTmpFileLen は szTmpFile に返されるデータのサイズ（終端の null 文字を含む文字数）を受け取る。バッファがすべてのデータを格納するには小さすぎる場合、lpuTmpFileLen にはデータを保持するために必要なバッファサイズが格納される。

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

解説

VerFindFile 関数から返された情報に基づいて、指定されたファイルをインストールする。VerInstallFile
は必要に応じてファイルを展開し、一意のファイル名を割り当て、古いファイルなどのエラーをチェックする。(Unicode)

[戻り値]
型: DWORD 戻り値は例外を示すビットマスクである。次の値の 1 つ以上を含む可能性がある。その他の値はすべて予約されている。
（以下省略）

[備考]
この関数は 16 ビット、32 ビット、64 ビットのファイルイメージで動作する。VerInstallFile
はソースディレクトリから対象ディレクトリへファイルをコピーする。szCurDir
がシステム上に以前のバージョンのファイルが存在することを示している場合、VerInstallFile
はファイルのバージョンスタンプ情報を比較する。以前にインストールされたバージョンが新しいバージョンより新しい場合、または属性に大きな差がある場合（例えば異なる言語である場合）、VerInstallFile
は 1 つ以上の回復可能なエラーコードを返す。VerInstallFile
は対象ディレクトリに一時ファイルを残す。アプリケーションはエラーを上書きするか、一時ファイルを削除できる。アプリケーションがエラーを上書きする場合、VerInstallFile
は以前にインストールされたバージョンを削除し、一時ファイルを元のファイル名に変更する。
> [!NOTE] > winver.h ヘッダは VerInstallFile を、UNICODE
プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode
版を自動的に選択するエイリアスとして定義している。エンコーディング中立なエイリアスとエンコーディング中立でないコードを混在させると、コンパイルや実行時のエラーにつながる不一致が発生する場合がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報