GetFileSizeEx

指定したファイルのサイズを取得する。

GetFileSizeEx hFile, lpFileSize

hFile : [intptr] ファイルへのハンドル。ハンドルは FILE_READ_ATTRIBUTES アクセス権または同等のもので作成されているか、呼び出し側がそのファイルを含むディレクトリに対し十分なアクセス権を持つ必要がある。詳細は File Security and Access Rights を参照。
lpFileSize : [var] ファイルサイズ(バイト単位)を受け取る LARGE_INTEGER 構造体へのポインタ。

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

解説

指定したファイルのサイズを取得する。

[戻り値]
関数が成功した場合の戻り値は 0 以外である。失敗した場合の戻り値は 0 である。拡張エラー情報を取得するには GetLastError
を呼ぶ。

[備考]
トランザクション操作:
ファイルハンドルにトランザクションがバインドされている場合、関数は分離されたファイルビューの情報を返す。Windows ストアアプリ:
GetFileSizeEx はサポートされない。代わりに GetFileInformationByHandleEx
を使用する。Windows 8 および Windows Server 2012 では、本関数は以下の技術によりサポートされている。
(以下省略)

情報

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