IEnumSTATPROPSTG-Compound 文件实现

IEnumSTATPROPSTG 接口的复合文件实现用于枚举属性,从而生成包含统计属性数据的 STATPROPSTG 结构。 IPropertyStorage 的实现管理统计数据,并与当前复合文件存储对象相关联。

IEnumSTATPROPSTG 的 COM 实现中的构造函数将创建一个读取整个属性集的类,并创建一个静态数组,该数组可在调用 IEnumSTATPROPSTG::Clone 时共享。

何时使用

调用 IEnumSTATPROPSTG 的复合文件实现以枚举包含有关当前属性集中属性的数据的 STATPROPSTG 结构。 使用属性存储接口的复合文件实现时,请调用 IPropertyStorage::Enum 返回指向 IEnumSTATPROPSTG 的指针,以管理属性存储对象及其中的元素。

备注

IEnumSTATPROPSTG::Next

获取下一个或多个 STATPROPSTG 结构, (数字是由 celt 参数) 指定的。 如果成功,则返回S_OK。

IEnumSTATPROPSTG::Skip

跳过 celt 中指定的元素数。 要通过调用 Next 枚举的下一个元素将成为跳过的元素之后的元素。 如果跳过 celt 元素,则返回S_OK;如果跳过的 celt 元素少于 ,则返回S_FALSE。

IEnumSTATPROPSTG::Reset

将光标设置为枚举的开头。 如果成功,则返回S_OK,否则返回STG_E_INVALIDHANDLE。

IEnumSTATPROPSTG::Clone

使用 IEnumSTATPROPSTG 的构造函数创建数组的副本。 由于构造静态数组的类实际上包含 对象,因此此函数主要将添加到引用计数中。

STATPROPSTG

IPropertyStorage::Enum