IShellIcon::GetIconOf-Methode (shobjidl_core.h)

  • Artikel

Ruft ein Symbol für ein Objekt in einem bestimmten Ordner ab.

Syntax

HRESULT GetIconOf(
  PCUITEMID_CHILD pidl,
  UINT            flags,
  int             *pIconIndex
);

Parameter

pidl

Typ: LPCITEMIDLIST

Die Adresse der ITEMIDLIST-Struktur , die den relativen Speicherort des Ordners angibt.

flags

Typ: UINT

Flags, die angeben, wie das Symbol angezeigt werden soll. Dieser Parameter kann null oder einer der folgenden Werte sein.

GIL_FORSHELL

Das Symbol soll in einem Shellordner angezeigt werden.

GIL_OPENICON

Das Symbol sollte geöffnet sein, wenn Sowohl Open-State- als auch Closed-State-Images verfügbar sind. Wenn dieses Flag nicht angegeben ist, sollte sich das Symbol im geschlossenen Zustand befinden. Dieses Flag wird in der Regel für Ordnerobjekte verwendet.

pIconIndex

Typ: LPINT

Die Adresse des Indexes des Symbols in der Systembildliste. Die folgenden Standardbildlistenindizes können zurückgegeben werden.

0

Dokument (leere Seite, nicht zugeordnet)

1

Dokument (mit Daten auf der Seite)

2

Anwendung (Dateinamenerweiterung muss .exe, .com oder .bat sein)

3

Ordner (einfach)

4

Ordner (geöffnet)

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn lpIconIndex den richtigen Systembildlistenindex enthält, oder S_FALSE, wenn für dieses Objekt kein Symbol abgerufen werden kann.

Hinweise

Wenn Sie kein Symbol für dieses Objekt mithilfe von GetIconOf abrufen können, verwenden Sie die GetUIObjectOf-Methode , um ein Objekt abzurufen, das die Extract-Methode unterstützt.

IShellIcon::GetIconOf schlägt fehl, wenn CoInitialize nicht zuerst aufgerufen wird.

Hinweis zum Aufrufen von Anwendungen

Der zurückgegebene Index stammt aus der Systemimageliste.

Hinweis für Implementierer

Wenn der verwendete Symbolindex nicht eines der aufgeführten Standardimages ist, liegt es in der Verantwortung des Implementierers, das Bild der Systembildliste hinzuzufügen und den Index dann im lpIconIndex-Parameter zu platzieren. Um zu verhindern, dass die Systemimageliste zu groß wird, sollte jedes Image nur einmal hinzugefügt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
DLL Shell32.dll (Version 4.0 oder höher)

Weitere Informationen

IShellIcon