CopyIcon, fonction (winuser.h)

Article
03/13/2024

Copie l’icône spécifiée d’un autre module vers le module actif.

Syntaxe

HICON CopyIcon(
  [in] HICON hIcon
);

Paramètres

[in] hIcon

Type : HICON

Handle de l’icône à copier.

Valeur retournée

Type : HICON

Si la fonction réussit, la valeur de retour est un handle de l’icône dupliquée.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction CopyIcon permet à une application ou à une DLL d’obtenir son propre handle sur une icône appartenant à un autre module. Si l’autre module est libéré, l’icône d’application peut toujours utiliser l’icône.

Avant la fermeture, une application doit appeler la fonction DestroyIcon pour libérer toutes les ressources système associées à l’icône.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-gui-l1-3-0 (introduit dans Windows 10, version 10.0.10240)