GetCompressedFileSizeTransactedW 函数（winbase.h）

项目
11/20/2024

[Microsoft强烈建议开发人员利用替代方法来实现应用程序的需求。 TxF 开发的许多方案可以通过更简单、更易用的技术来实现。此外，TxF 在 Microsoft Windows 的未来版本中可能不可用。有关详细信息，以及 TxF 的替代项，请参阅使用事务 NTFS的替代项。]

检索用于将指定文件存储为事务操作的实际磁盘存储字节数。如果文件位于支持压缩和压缩文件的卷上，则获取的值是指定文件的压缩大小。如果该文件位于支持稀疏文件的卷上，并且该文件是稀疏文件，则获取的值是指定文件的稀疏大小。

语法

DWORD GetCompressedFileSizeTransactedW(
  [in]            LPCWSTR lpFileName,
  [out, optional] LPDWORD lpFileSizeHigh,
  [in]            HANDLE  hTransaction
);

参数

[in] lpFileName

文件的名称。

不要在不可见的设备上指定文件的名称，例如管道或通信设备，因为它的文件大小没有意义。

该文件必须驻留在本地计算机上;否则，函数将失败，最后一个错误代码设置为 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE。

[out, optional] lpFileSizeHigh

指向一个变量的指针，该变量接收压缩文件大小的 DWORD。函数的返回值是压缩文件大小的低序 DWORD。

如果不需要压缩文件大小的 DWORD，则可以 NULL 此参数。大小小于 4 GB 的文件不需要高阶 DWORD。

[in] hTransaction

事务的句柄。此句柄由 CreateTransaction 函数返回。

返回值

如果函数成功，则返回值是用于存储指定文件的实际磁盘存储字节数的低序 DWORD，如果 lpFileSizeHigh 为非NULL，则该函数会将该实际值的高阶 DWORD 放入该参数指向 DWORD。这是压缩文件的压缩文件大小，非压缩文件的实际文件大小。

如果函数失败，并且 lpFileSizeHighNULL，则返回值 INVALID_FILE_SIZE。若要获取扩展的错误信息，请调用 GetLastError。

如果返回值 INVALID_FILE_SIZE 且 lpFileSizeHigh 为非NULL，则应用程序必须调用 GetLastError 来确定函数是否成功（值为 NO_ERROR）或失败（值不是 NO_ERROR）。

言论

应用程序可以通过调用 GetVolumeInformation来确定卷是否压缩，然后在该函数的 lpFileSystemFlags 参数指向的 DWORD 值中检查 FS_VOL_IS_COMPRESSED 标志的状态。

如果文件不位于支持压缩或稀疏文件的卷上，或者该文件未压缩或稀疏文件，则获取的值是实际文件大小，与调用 getFileSize返回的值相同。

符号链接：如果路径指向符号链接，该函数将返回目标的文件大小。

在 Windows 8 和 Windows Server 2012 中，以下技术支持此函数。

科技	支持
服务器消息块（SMB） 3.0 协议	不
SMB 3.0 透明故障转移（TFO）	不
具有横向扩展文件共享的 SMB 3.0 （SO）	不
群集共享卷文件系统（CsvFS）	不
可复原文件系统（ReFS）	不

SMB 3.0 不支持 TxF。

注意

winbase.h 标头根据 UNICODE 预处理器常量的定义，将 GetCompressedFileSizeTransacted 定义为自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows Vista [仅限桌面应用]
支持的最低服务器	Windows Server 2008 [仅限桌面应用]
目标平台	窗户
标头	winbase.h （包括 Windows.h）
库	Kernel32.lib
DLL	Kernel32.dll