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 协议 | 是 |
SMB 3.0 透明故障转移 (TFO) | 是 |
具有横向扩展文件共享的 SMB 3.0 (SO) | 是 |
群集共享卷文件系统 (CSV) | 是 |
弹性文件系统 (ReFS) | 是 |
要求
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | fileapi.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |