GetIconInfo-Funktion (winuser.h)
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) |
Siehe auch
Konzept