Funzione CopyIcon (winuser.h)

Articolo
03/04/2024

Copia l'icona specificata da un altro modulo al modulo corrente.

Sintassi

HICON CopyIcon(
  [in] HICON hIcon
);

Parametri

[in] hIcon

Tipo: HICON

Handle all'icona da copiare.

Valore restituito

Tipo: HICON

Se la funzione ha esito positivo, il valore restituito è un handle per l'icona duplicata.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione CopyIcon consente a un'applicazione o a una DLL di ottenere il proprio handle in un'icona di proprietà di un altro modulo. Se l'altro modulo viene liberato, l'icona dell'applicazione sarà comunque in grado di usare l'icona.

Prima di chiudere, un'applicazione deve chiamare la funzione DestroyIcon per liberare tutte le risorse di sistema associate all'icona.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-gui-l1-3-0 (introdotta in Windows 10, versione 10.0.10240)