IShellImageData：：CloneFrame 方法 (shimgdata.h)

擷取目前影像或框架的複本。

語法

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

[in, out] ppImg

類型： Image**

接收複製映像指標的位址。如果這個專案上的此參數為 NULL ，則為未處理的例外狀況結果。

類型： HRESULT

如果成功或錯誤值，則傳回S_OK，包括下列專案：

傳回碼	Description
E_FAIL	ppImg 參數在專案上為 NULL，或無法複製映像。在後者的情況下， ppImg 會設定為 NULL。

在多框架映像的案例中，例如 .gif 檔案，則會複製目前的框架。如果是非多框架映像，例如 .jpg 檔案，則會複製整個映射。