Função DestroyCursor (winuser.h)

Artigo
03/04/2024

Destrói um cursor e libera qualquer memória ocupada pelo cursor. Não use essa função para destruir um cursor compartilhado.

Sintaxe

BOOL DestroyCursor(
  [in] HCURSOR hCursor
);

Parâmetros

[in] hCursor

Tipo: HCURSOR

Um identificador para o cursor a ser destruído. O cursor 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

A função DestroyCursor destrói um cursor não compartilhado. Não use essa função para destruir um cursor compartilhado. Um cursor compartilhado é válido desde que o módulo do qual ele foi carregado permaneça na memória. As seguintes funções obtêm um cursor compartilhado:

Loadcursor
LoadCursorFromFile
LoadImage (se você usar o sinalizador LR_SHARED )
CopyImage (se você usar o sinalizador LR_COPYRETURNORG e o parâmetro hImage for um cursor 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