IStream_Size 函数 (shlwapi.h)

检索指定流的大小(以字节为单位)。

语法

LWSTDAPI IStream_Size(
  [in]  IStream        *pstm,
  [out] ULARGE_INTEGER *pui
);

参数

[in] pstm

类型: IStream*

指向要确定其大小的流的 IStream 接口的指针。

[out] pui

类型: ULARGE_INTEGER*

指向 ULARGE_INTEGER 结构的指针,用于接收流的大小。

返回值

类型: HRESULT

返回 成功时S_OK ,否则返回 COM 失败代码。 有关可能的错误代码的进一步讨论,请参阅 IStream::Stat

注解

此函数通过调用指定流对象的 IStream::Stat 方法获取流的大小。 然后,它将 IStream::Stat 返回的 STATSTG 结构的 cbSize 成员的值复制到 pui 指向的 ULARGE_INTEGER 结构。 如果函数失败,则 未定义ULARGE_INTEGER 结构的内容。

要求

要求
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server、Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
DLL Shlwapi.dll (5.0 或更高版本)