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