GetIconInfoExA-Funktion (winuser.h)

Artikel
03/04/2024

Ruft Informationen zum angegebenen Symbol oder Cursor ab. GetIconInfoEx erweitert GetIconInfo mithilfe der neueren ICONINFOEX-Struktur .

Syntax

BOOL GetIconInfoExA(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXA piconinfo
);

Parameter

[in] hicon

Typ: HICON

Ein Handle für das Symbol oder den Cursor.

Um Informationen zu einem Standardsymbol oder -cursor abzurufen, geben Sie den Bezeichner ab dem präfix IDI_ oder den Bezeichner ab dem präfix IDC_ in diesem Parameter an.

[in, out] piconinfo

Typ: PICONINFOEX

Wenn diese Methode zurückgibt, enthält einen Zeiger auf eine ICONINFOEX-Struktur . Die Funktion füllt die Elemente der Struktur aus.

Rückgabewert

Typ: BOOL

TRUE gibt den Erfolg an, FALSE einen Fehler.

Hinweise

GetIconInfoEx erstellt Bitmaps für hbmMask und hbmColor oder Elemente von ICONINFOEX. Die aufrufende Anwendung muss diese Bitmaps verwalten und mit dem DeleteObject-Aufruf löschen, wenn sie nicht mehr erforderlich sind.

DPI-Virtualisierung

Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die zurückgegebene Ausgabe wird nicht von der DPI des aufrufenden Threads beeinflusst.

Hinweis

Der winuser.h-Header definiert GetIconInfoEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll