Функция 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