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