GetFileVersionInfoSizeExW

オペレーティングシステムが指定されたファイルのバージョン情報を取得できるかどうかを判定する。バージョン情報が利用可能な場合、GetFileVersionInfoSizeEx はその情報のサイズ(バイト単位)を返す。(Unicode)

GetFileVersionInfoSizeExW dwFlags, lpwstrFilename, lpdwHandle

dwFlags : [int] 型: DWORD バージョンリソースを抽出する MUI DLL(存在する場合)を制御する。以下のフラグから 0 個以上を指定する。
lpwstrFilename : [wstr] 型: LPCTSTR 対象ファイルの名前。関数は LoadLibrary 関数で指定された検索順序を使用する。
lpdwHandle : [var] 型: LPDWORD 関数が戻ったとき、変数へのポインタを保持する。この変数は本関数によって 0 に設定される。このパラメータは歴史的な理由で存在する。

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

解説

オペレーティングシステムが指定されたファイルのバージョン情報を取得できるかどうかを判定する。バージョン情報が利用可能な場合、GetFileVersionInfoSizeEx
はその情報のサイズ(バイト単位)を返す。(Unicode)

[戻り値]
型: DWORD 関数が成功した場合、戻り値はファイルのバージョン情報のサイズ(バイト単位)となる。
関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
GetFileVersionInfoEx 関数を呼び出す前に GetFileVersionInfoSizeEx
関数を呼び出すこと。GetFileVersionInfoSizeEx が返すサイズは、GetFileVersionInfoEx
が返すバージョン情報を格納するために必要なバッファサイズを示す。
> [!NOTE] > winver.h ヘッダは GetFileVersionInfoSizeEx を、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