Função DestroyIcon (winuser.h)

Artigo
03/04/2024

Destrói um ícone e libera qualquer memória que o ícone ocupou.

Sintaxe

BOOL DestroyIcon(
  [in] HICON hIcon
);

Parâmetros

[in] hIcon

Tipo: HICON

Um identificador para o ícone a ser destruído. O ícone não deve estar em uso.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Só é necessário chamar DestroyIcon para ícones e cursores criados com as seguintes funções: CreateIconFromResourceEx (se chamado sem o sinalizador LR_SHARED ), CreateIconIndirect e CopyIcon. Não use essa função para destruir um ícone compartilhado. Um ícone compartilhado é válido desde que o módulo do qual ele foi carregado permaneça na memória. As funções a seguir obtêm um ícone compartilhado.

Loadicon
LoadImage (se você usar o sinalizador LR_SHARED )
CopyImage (se você usar o sinalizador LR_COPYRETURNORG e o parâmetro hImage for um ícone compartilhado)
CreateIconFromResource
CreateIconFromResourceEx (se você usar o sinalizador LR_SHARED )

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-1-0 (introduzido em Windows 8)