GetFileVersionInfoExW

指定されたファイルのバージョン情報を取得する。(GetFileVersionInfoExW)

GetFileVersionInfoExW dwFlags, lpwstrFilename, dwHandle, dwLen, lpData

dwFlags : [int] 型: DWORD バージョンリソースを抽出する MUI DLL(存在する場合)を制御する。このフラグの値は、dwLen パラメータに渡すバッファサイズを決定するために使用した対応する GetFileVersionInfoSizeEx 呼び出しに渡したフラグと一致する必要がある。以下のフラグから 0 個以上を指定する。
lpwstrFilename : [wstr] 型: LPCTSTR ファイル名。フルパスが指定されていない場合、関数は LoadLibrary 関数で指定された検索順序を使用する。
dwHandle : [int] 型: DWORD このパラメータは無視される。
dwLen : [int] 型: DWORD lpData パラメータが指すバッファのサイズ(バイト単位)。
lpData : [intptr] 型: LPVOID 関数が戻ったとき、ファイルのバージョン情報を格納したバッファへのポインタを保持する。この値は、後続の VerQueryValue 関数の呼び出しでバッファからデータを取得するために使用できる。

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

解説

指定されたファイルのバージョン情報を取得する。(GetFileVersionInfoExW)

[戻り値]
型: BOOL 関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。

[備考]
GetFileVersionInfoEx 関数を呼び出す前に GetFileVersionInfoSizeEx
関数を呼び出すこと。ファイルバージョン情報バッファから情報を取得するには、VerQueryValue 関数を使用する。
> [!NOTE] > winver.h ヘッダは GetFileVersionInfoEx を、UNICODE
プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode
版を自動的に選択するエイリアスとして定義している。エンコーディング中立なエイリアスとエンコーディング中立でないコードを混在させると、コンパイルや実行時のエラーにつながる不一致が発生する場合がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報

プラグイン / モジュールversion.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の version.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_version_gen2.hs