Freigeben über


IShellImageData::CloneFrame-Methode (shimgdata.h)

Ruft einen Klon des aktuellen Bilds oder Frames ab.

Syntax

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

Parameter

[in, out] ppImg

Typ: Image**

Die Adresse, die einen Zeiger auf das Klonimage empfängt. Wenn dieser Parameter beim Eintrag NULL ist, wird eine nicht behandelte Ausnahme ausgelöst.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, falls erfolgreich oder andernfalls ein Fehlerwert, einschließlich der folgenden:

Rückgabecode Beschreibung
E_FAIL
Der ppImg-Parameter ist beim Eintrag NULL , oder das Image kann nicht geklont werden. Im letzteren Fall ist ppImg auf NULL festgelegt.

Hinweise

Im Fall eines mehrformatigen Bilds, z. B. einer .gif-Datei, wird der aktuelle Frame geklont. Bei Nicht-Multiframe-Bildern wie einer .jpg-Datei wird das gesamte Bild geklont.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shimgdata.h
DLL Shell32.dll