IShellImageData::D ecode-Methode (shimgdata.h)

Artikel
03/02/2024

Decodiert die Bilddatei, und legt den Status fest.

Syntax

HRESULT Decode(
  [in] DWORD dwFlags,
  [in] ULONG cxDesired,
  [in] ULONG cyDesired
);

Parameter

[in] dwFlags

Art: DWORD

Eines der folgenden Flags.

SHIMGDEC_DEFAULT (0x00)

Erstellen Sie ein vollständiges Image.

SHIMGDEC_THUMBNAIL (0x01)

Decodieren Sie nur das Miniaturbild.

SHIMGDEC_LOADFULL (0x02)

Laden Sie die gesamte Bilddatei in den Arbeitsspeicher.

[in] cxDesired

Typ: ULONG

Die gewünschte horizontale Größe des decodierten Bilds. Dieser Parameter wird nur verwendet, wenn das flag SHIMGDEC_THUMBNAIL festgelegt ist. Wenn stattdessen das SHIMGDEC_DEFAULT-Flag festgelegt ist, wird dieser Wert ignoriert.

[in] cyDesired

Typ: ULONG

Die gewünschte vertikale Größe des decodierten Bilds. Dieser Parameter wird nur verwendet, wenn das flag SHIMGDEC_THUMBNAIL festgelegt ist. Wenn stattdessen das SHIMGDEC_DEFAULT-Flag festgelegt ist, wird dieser Wert ignoriert.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode	Beschreibung
E_FAIL	Die Datei konnte nicht geladen werden, oder die aufrufende Anwendung beendete den Decodierungsprozess durch einen Aufruf eines registrierten IShellImageDataAbort (weitere Informationen finden Sie unter IShellImageData::RegisterAbort ).
E_OUTOFMEMORY	Das interne Objekt kann nicht instanziiert werden.
E_NOTIMPL	Der Pfad, der zum Erstellen dieser instance von IShellImageData verwendet wurde, war eine URL.
S_FALSE	Das Bild wurde bereits decodiert.

Hinweise

IShellImageData::D ecode muss aufgerufen werden, bevor die meisten IShellImageData-Methoden aufgerufen werden. Wenn dies nicht der Fall ist, schlagen diese Methoden fehl.

IShellImageData::D ecode versucht, das Seitenverhältnis des ursprünglichen Bilds beizubehalten, sodass einer der in cxDesired oder cyDesired übergebenen Werte dazu überschrieben werden kann.

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

Freigeben über