IShellImageData：：CloneFrame 方法 (shimgdata.h)

检索当前图像或帧的克隆。

语法

HRESULT CloneFrame(
  [in, out] Image **ppImg
);

参数

[in, out] ppImg

类型： 图像**

接收指向克隆映像的指针的地址。 如果此参数在输入时为 NULL ，则会导致未经处理的异常。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值，包括以下内容：

返回代码	说明
E_FAIL	ppImg 参数在输入时为 NULL，或者无法克隆映像。 在后一种情况下， ppImg 设置为 NULL。

注解

对于多帧图像（如 .gif 文件），将克隆当前帧。 对于非多帧图像（如 .jpg 文件），将克隆整个映像。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	shimgdata.h
DLL	Shell32.dll