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

Confira também

Conceitual

CopyIcon

CreateIconFromResource

CreateIconFromResourceEx

CreateIconIndirect

Ícones

Referência