Функция GetFileSizeEx (fileapi.h)

Извлекает размер указанного файла.

Синтаксис

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

Параметры

[in] hFile

Дескриптор файла. Дескриптор должен быть создан с правом доступа FILE_READ_ATTRIBUTES или эквивалентным, либо вызывающий объект должен иметь достаточные разрешения на каталог, содержащий файл. Дополнительные сведения см. в разделе Безопасность файлов и права доступа.

[out] lpFileSize

Указатель на структуру LARGE_INTEGER , которая получает размер файла в байтах.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Транзакции операций: Если к дескриптору файла привязана транзакция, функция возвращает сведения для представления изолированного файла.

Приложения Магазина Windows: GetFileSizeEx не поддерживается. Используйте GetFileInformationByHandleEx.

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология	Поддерживается
Протокол SMB 3.0	Да
Прозрачная отработка отказа (TFO) SMB 3.0	Да
SMB 3.0 с масштабируемыми общими папками (SO)	Да
Файловая система общего тома кластера (CSVFS)	Да
Восстанавливаемая файловая система (ReFS)	Да

Требования

Минимальная версия клиента	Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	fileapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

Функции управления файлами

LARGE_INTEGER