IStream::Stat 方法 (objidl.h)

Stat 方法检索此流的 STATSTG 结构。

语法

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

参数

[out] pstatstg

指向 STATSTG 结构的指针,此方法在其中放置有关此流对象的信息。

[in] grfStatFlag

指定此方法不返回 STATSTG 结构中的某些成员,从而保存内存分配操作。 值取自 STATFLAG 枚举。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK 在指定位置成功返回 STATSTG 结构。
E_PENDING 仅限异步存储:流的部分或全部数据当前不可用。
STG_E_ACCESSDENIED 调用方没有足够的权限来访问此存储对象的统计信息。
STG_E_INSUFFICIENTMEMORY 由于缺少内存,未返回 STATSTG 结构。
STG_E_INVALIDFLAG grfStateFlag 参数的值无效。
STG_E_INVALIDPOINTER pStatStg 指针无效。
STG_E_REVERTED 在事务树中,对象上方的还原操作已失效。

注解

IStream::Stat 检索指向 STATSTG 结构的指针,该结构包含有关此打开的流的信息。 当此流位于结构化存储中并且调用 IStorage::EnumElements 时,它会创建一个在其上具有 IEnumSTATSTG 接口的枚举器对象,该对象可以调用该对象通过与每个存储关联的 STATSTG 结构来枚举存储和流。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 objidl.h
Library Uuid.lib
DLL Ole32.dll

另请参阅

IStream - 复合文件实现

STATFLAG

STATSTG