SHGetStockIconInfo-Funktion (shellapi.h)

Artikel
08/26/2023

Ruft Informationen zu systemdefinierte Shellsymbolen ab.

Syntax

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

Parameter

siid

Typ: SHSTOCKICONID

Einer der Werte aus der SHSTOCKICONID-Enumeration , der 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 den Symbolindex des angeforderten Symbols in einem Format, das für die Übergabe 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 ein 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 wert der SHGSI_ICON, indem die Funktion die Linküberlagerung zum Symbol der Datei hinzugibt.

SHGSI_SELECTED

Ändert den SHGSI_ICON-Wert, indem die Funktion das Symbol mit der Systemherhebungsfarbe vermischt.

SHGSI_LARGEICON

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

SHGSI_SMALLICON

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

SHGSI_SHELLICONSIZE

Ändert die SHGSI_LARGEICON- oder SHGSI_SMALLICON-Werte, indem die Funktion anstelle der in den Systemmetriken angegebenen Größen die Symbole in Shellgröße abruft.

[in, out] psii

Typ: SHSTOCKICONINFO*

Ein Zeiger auf eine SHSTOCKICONINFO-Struktur . Wenn diese Funktion aufgerufen wird, muss der cbSize-Member dieser Struktur auf die Größe der SHSTOCKICONINFO-Struktur festgelegt werden. Wenn diese Funktion zurückgibt, enthält 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 Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn diese Funktion einen Symbolhandle im hIcon-Member 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
DLL	Shell32.dll
APIs	ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)

Freigeben über