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 |
|---|---|
|
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 |