GetFileSizeEx 関数 (fileapi.h)

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

構文

BOOL GetFileSizeEx(
  [in]  HANDLE         hFile,
  [out] PLARGE_INTEGER lpFileSize
);

パラメーター

[in] hFile

ファイルへのハンドル。 ハンドルは、 FILE_READ_ATTRIBUTES アクセス権または同等の権限で作成されている必要があります。または、呼び出し元は、ファイルを含むディレクトリに対する十分なアクセス許可を持っている必要があります。 詳細については、「 ファイル のセキュリティとアクセス権」を参照してください。

[out] lpFileSize

ファイル サイズを受け取る LARGE_INTEGER 構造体へのポインター (バイト単位)。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

トランザクション操作: ファイル ハンドルにバインドされたトランザクションがある場合、関数は分離されたファイル ビューの情報を返します。

Windows ストア アプリ: GetFileSizeEx はサポートされていません。 GetFileInformationByHandleEx を使用します。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

テクノロジ	サポートされています
サーバー メッセージ ブロック (SMB) 3.0 プロトコル	はい
SMB 3.0 Transparent Failover (TFO)	はい
スケールアウト ファイル共有 (SO) を使う SMB 3.0	はい
クラスターの共有ボリューム ファイル システム (CsvFS)	はい
Resilient File System (ReFS)	はい

要件

サポートされている最小のクライアント	Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	fileapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

File Management 関数

LARGE_INTEGER