GetIconInfoExW-Funktion (winuser.h)

Artikel
06/21/2023

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

Syntax

BOOL GetIconInfoExW(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXW 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 an, der mit dem präfix IDI_ beginnt, oder den Bezeichner, der mit dem IDC_ Präfix in diesem Parameter beginnt.

[in, out] piconinfo

Typ: PICONINFOEX

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

Rückgabewert

Typ: BOOL

TRUE gibt den Erfolg an, FALSE gibt einen Fehler an.

Hinweise

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

DPI-Virtualisierung

Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die zurückgegebene Ausgabe wird vom DPI-Wert des aufrufenden Threads nicht 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 Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll