IEnumProgressItems::Clone 方法 (imapi2fs.h)

创建另一个枚举器,其中包含与当前枚举器相同的枚举状态。

语法

HRESULT Clone(
  [out] IEnumProgressItems **ppEnum
);

parameters

[out] ppEnum

接收指向枚举对象的接口指针。 如果该方法不成功,则此输出变量的值未定义。 完成后,必须释放 ppEnum

返回值

成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_POINTER
指针无效。

值:0x80004003

E_OUTOFMEMORY
未能分配所需的内存。

值:0x8007000E

注解

使用此方法,客户端可以记录枚举序列中的特定点,然后在以后返回到该点。 新的枚举器支持与原始枚举器相同的接口。

要求

   
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2fs.h

另请参阅

IEnumProgressItems

IProgressItems