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