Função CopyIcon (winuser.h)

Artigo
03/13/2024

Copia o ícone especificado de outro módulo para o módulo atual.

Sintaxe

HICON CopyIcon(
  [in] HICON hIcon
);

Parâmetros

[in] hIcon

Tipo: HICON

Um identificador para o ícone a ser copiado.

Retornar valor

Tipo: HICON

Se a função for bem-sucedida, o valor retornado será um identificador para o ícone duplicado.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função CopyIcon permite que um aplicativo ou DLL obtenha seu próprio identificador para um ícone pertencente a outro módulo. Se o outro módulo for liberado, o ícone do aplicativo ainda poderá usar o ícone.

Antes de fechar, um aplicativo deve chamar a função DestroyIcon para liberar todos os recursos do sistema associados ao ícone.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-gui-l1-3-0 (introduzido no Windows 10, versão 10.0.10240)