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.
- 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) |
Confira também
Conceitual
Referência