CopyIcon-Funktion (winuser.h)
Kopiert das angegebene Symbol aus einem anderen Modul in das aktuelle Modul.
HICON CopyIcon(
[in] HICON hIcon
);
[in] hIcon
Typ: HICON
Ein Handle für das zu kopierende Symbol.
Typ: HICON
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das duplizierte Symbol.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Die CopyIcon-Funktion ermöglicht es einer Anwendung oder DLL, ein eigenes Handle für ein Symbol abzurufen, das sich im Besitz eines anderen Moduls befindet. Wenn das andere Modul freigegeben wird, kann das Anwendungssymbol weiterhin das Symbol verwenden.
Vor dem Schließen muss eine Anwendung die DestroyIcon-Funktion aufrufen, um alle Systemressourcen freizugeben, die dem Symbol zugeordnet sind.
| 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 (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-gui-l1-3-0 (eingeführt in Windows 10, Version 10.0.10240) |
Konzept
Referenz