Partager via


CopyIcon, fonction (winuser.h)

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)

Voir aussi

Conceptuel

CopyCursor

DestroyIcon

DrawIcon

DrawIconEx

Icônes

Référence