Share via

IShellImageStore::GetEntry-Methode (shlobj.h)

  • Artikel

[IShellImageStore wird über Windows XP unterstützt. Es wird in späteren Betriebssystemen nicht unterstützt.]

Ruft ein Handle für ein Image im Cache ab.

Syntax

HRESULT GetEntry(
  [in]  PCWSTR  pszName,
        DWORD   dwMode,
  [out] HBITMAP *phImage
);

Parameter

[in] pszName

Typ: PCWSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Pfad zu der Datei angibt, die das Image enthält.

dwMode

Art: DWORD

Der Speicherinstanziierungsmodus, der durch einen der STGM-Werte angegeben wird.

[out] phImage

Typ: HBITMAP*

Ein Zeiger auf das Handle der Bitmap.

Rückgabewert

Typ: HRESULT

Gibt das Ergebnis von ISequentialStream::Read zurück, wenn der Prozess erfolgreich war. Gibt andernfalls einen der folgenden Werte zurück:

Rückgabecode Beschreibung
E_UNEXPECTED
 Der Speicher ist nicht geöffnet.
E_FAIL
 Der Stream wurde nicht gefunden.

Hinweise

Es liegt in der Verantwortung des Aufrufers, das Handle nach einem Aufruf dieser Methode frei zu geben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj.h
DLL Shell32.dll (Version 5.0 oder höher)