IStorage::EnumElements 方法 (objidl.h)

EnumElements 方法检索指向枚举器对象的指针,该指针可用于枚举此存储对象中包含的存储和流对象。

语法

HRESULT EnumElements(
  [in]  DWORD        reserved1,
  [in]  void         *reserved2,
  [in]  DWORD        reserved3,
  [out] IEnumSTATSTG **ppenum
);

参数

[in] reserved1

留待将来使用;必须为零。

[in] reserved2

保留供将来使用;必须为 NULL

[in] reserved3

留待将来使用;必须为零。

[out] ppenum

指向 IEnumSTATSTG* 指针变量的指针,该变量接收指向新枚举器对象的接口指针。

返回值

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

返回代码 说明
S_OK 已成功返回枚举器对象。
E_PENDING 仅异步存储:元素的部分或全部数据当前不可用。
STG_E_INSUFFICIENTMEMORY 由于内存不足,无法创建枚举器对象。
STG_E_INVALIDPARAMETER 其中一个参数无效。
STG_E_REVERTED 存储对象在事务树中的上方还原操作已失效。

注解

此方法返回的枚举器对象实现 IEnumSTATSTG 接口,该接口是包含 NextResetCloneSkip 方法的标准枚举器接口之一。 IEnumSTATSTG 枚举存储在 STATSTG 结构数组中的数据。

存储对象必须在读取模式下打开,才能允许枚举其元素。

允许枚举器对象以任何顺序枚举元素。 还允许枚举器对象将枚举视为快照或使枚举反映存储对象的当前状态。

要求

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

另请参阅

IEnumSTATSTG

IStorage - 复合文件实现

STATSTG