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