バージョン情報

[アーティクル]
06/13/2023

バージョン情報を使用すると、アプリケーションでファイルを適切にインストールしやすくなり、セットアッププログラムで現在インストールされているファイルを分析できます。バージョン情報リソースには、ファイルのバージョン番号、目的のオペレーティングシステム、および元のファイル名が含まれます。

このセクションの内容

名前	説明
バージョン情報について	バージョン情報関数について説明します。
バージョン情報の使用	バージョン情報関数の使用方法について説明します。
バージョン情報リファレンス	API リファレンスを含みます。

バージョン情報関数

名前	説明
GetFileVersionInfo	指定したファイルのバージョン情報を取得します。
GetFileVersionInfoEx	指定したファイルのバージョン情報を取得します。
GetFileVersionInfoSize	オペレーティングシステムが指定したファイルのバージョン情報を取得できるかどうかを判断します。バージョン情報が使用可能な場合、 GetFileVersionInfoSize は、その情報のサイズ (バイト単位) を返します。
GetFileVersionInfoSizeEx	オペレーティングシステムが指定したファイルのバージョン情報を取得できるかどうかを判断します。バージョン情報が使用可能な場合、 GetFileVersionInfoSizeEx は、その情報のサイズをバイト単位で返します。
VerFindFile	システム内の別のバージョンのファイルが見つからないかどうかに基づいて、ファイルをインストールする場所を決定します。指定したバッファーで返される値 VerFindFile は、 VerInstallFile 関数の後続の呼び出しで使用されます。
VerInstallFile	VerFindFile 関数から返された情報に基づいて、指定されたファイルをインストールします。 VerInstallFile は、必要に応じてファイルを圧縮解除し、一意のファイル名を割り当て、古いファイルなどのエラーをチェックします。
VerLanguageName	指定したバイナリ Microsoft 言語識別子に関連付けられている言語の説明文字列を取得します。
VerQueryValue	指定したバージョン情報リソースから、指定したバージョン情報を取得します。適切なリソースを取得するには、 VerQueryValue を呼び出す前に、まず GetFileVersionInfoSize 関数を呼び出してから、 GetFileVersionInfo 関数を呼び出す必要があります。

バージョン情報の構造

名前	説明
String	ファイルバージョンのリソース内のデータのorganizationを示します。ファイルの特定の側面 (ファイルのバージョン、著作権情報、商標など) を記述する文字列が含まれています。
StringFileInfo	ファイルバージョンのリソース内のデータのorganizationを示します。これには、特定の言語とコードページに対して表示できるバージョン情報が含まれています。
StringTable	ファイルバージョンのリソース内のデータのorganizationを示します。 Children メンバーによって指定された文字列の言語とコードページの書式設定情報が含まれています。コードページは順序付けされた文字セットです。
Var	ファイルバージョンのリソース内のデータのorganizationを示します。通常、アプリケーションまたは DLL のバージョンでサポートされている言語とコードページ識別子のペアの一覧が含まれています。
VarFileInfo	ファイルバージョンのリソース内のデータのorganizationを示します。これには、特定の言語とコードページの組み合わせに依存しないバージョン情報が含まれています。
VS_FIXEDFILEINFO	ファイルに関するバージョン情報が含まれます。この情報は言語とコードページに依存しません。
VS_VERSIONINFO	ファイルバージョンのリソース内のデータのorganizationを示します。これは、他のすべてのファイルバージョン情報構造を含むルート構造です。