IShellIcon::GetIconOf-Methode (shobjidl_core.h)
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) |