SHGetStockIconInfo-Funktion (shellapi.h)

Ruft Informationen zu systemdefinierten Shellsymbolen ab.

Syntax

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

Die Parameter

siid

Typ: SHSTOCKICONID

Einer der Werte aus der SHSTOCKICONID-Aufzählung , die angibt, welches Symbol abgerufen werden soll.

uFlags

Typ: UINT

Eine Kombination aus Null oder mehr der folgenden Flags, die angeben, welche Informationen angefordert werden.

SHGSI_ICONLOCATION

Die Elemente szPath und iIcon der SHSTOCKICONINFO-Struktur erhalten den Pfad- und Symbolindex des angeforderten Symbols in einem Format, das zum Übergeben an die ExtractIcon-Funktion geeignet ist. Der numerische Wert dieses Flags ist null, sodass Sie unabhängig von anderen Flags immer die Symbolposition erhalten.

SHGSI_ICON

Das hIcon-Element der SHSTOCKICONINFO-Struktur empfängt einen Handle für das angegebene Symbol.

SHGSI_SYSICONINDEX

Das iSysImageImage-Element der SHSTOCKICONINFO-Struktur empfängt den Index des angegebenen Symbols in der Systembildliste.

SHGSI_LINKOVERLAY

Ändert den SHGSI_ICON Wert, indem die Funktion die Verknüpfungsüberlagerung zum Symbol der Datei hinzufügen kann.

SHGSI_SELECTED

Ändert den SHGSI_ICON Wert, indem die Funktion das Symbol mit der Farbe für die Systemmarkierung vermischt.

SHGSI_LARGEICON

Ändert den SHGSI_ICON Wert, indem die Funktion die große Version des Symbols abruft, wie durch die SM_CXICON und SM_CYICON Systemmetriken angegeben.

SHGSI_SMALLICON

Ändert den SHGSI_ICON Wert, indem die Funktion die kleine Version des Symbols abruft, wie durch die SM_CXSMICON und SM_CYSMICON Systemmetriken angegeben.

SHGSI_SHELLICONSIZE

Ändert die SHGSI_LARGEICON- oder SHGSI_SMALLICON Werte, indem die Funktion die Shell-Größensymbole anstelle der durch die Systemmetriken angegebenen Größen abruft.

[in, out] psii

Typ: SHSTOCKICONINFO*

Ein Zeiger auf eine SHSTOCKICONINFO-Struktur . Wenn diese Funktion aufgerufen wird, muss das cbSize-Element dieser Struktur auf die Größe der SHSTOCKICONINFO-Struktur festgelegt werden. Wenn diese Funktion zurückgegeben wird, enthält sie einen Zeiger auf eine SHSTOCKICONINFO-Struktur , die die angeforderten Informationen enthält.

Rückgabewert

Typ: HRESULT-

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Wenn diese Funktion einen Symbolziehpunkt im hIcon-Element der SHSTOCKICONINFO-Struktur zurückgibt, auf die psii verweist, sind Sie dafür verantwortlich, das Symbol mit DestroyIcon frei zu geben, wenn Sie es nicht mehr benötigen.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
API-Satz	ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)