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 接口,该接口是包含 Next、 Reset、 Clone 和 Skip 方法的标准枚举器接口之一。 IEnumSTATSTG 枚举存储在 STATSTG 结构数组中的数据。
存储对象必须在读取模式下打开,才能允许枚举其元素。
允许枚举器对象以任何顺序枚举元素。 还允许枚举器对象将枚举视为快照或使枚举反映存储对象的当前状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | objidl.h |
Library | Uuid.lib |
DLL | Ole32.dll |