GetIconInfo-Funktion (winuser.h)

Artikel
03/04/2024

Ruft Informationen zum angegebenen Symbol oder Cursor ab.

Syntax

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO 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.

[out] piconinfo

Typ: PICONINFO

Ein Zeiger auf eine ICONINFO-Struktur . Die Funktion füllt die Elemente der Struktur aus.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert nonzero, und die Funktion füllt die Member der angegebenen ICONINFO-Struktur aus.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

GetIconInfo erstellt Bitmaps für hbmMask und hbmColor oder Elemente von ICONINFO. 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.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-gui-l1-1-0 (eingeführt in Windows 8)