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 |