Compartilhar via


Função DestroyIcon (winuser.h)

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.

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)

Confira também

Conceitual

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

Ícones

Referência