Função UnregisterClassA (winuser.h)

Cancela o registro de uma classe de janela, liberando a memória necessária para a classe .

Sintaxe

BOOL UnregisterClassA(
  [in]           LPCSTR    lpClassName,
  [in, optional] HINSTANCE hInstance
);

Parâmetros

[in] lpClassName

Tipo: LPCTSTR

Uma cadeia de caracteres terminada em nulo ou um atom de classe. Se lpClassName for uma cadeia de caracteres, ele especificará o nome da classe de janela. Esse nome de classe deve ter sido registrado por uma chamada anterior para a função RegisterClass ou RegisterClassEx . As classes do sistema, como controles de caixa de diálogo, não podem ser canceladas. Se esse parâmetro for um atom, ele deverá ser um atom de classe criado por uma chamada anterior para a função RegisterClass ou RegisterClassEx . O átomo deve estar na palavra de baixa ordem de lpClassName; a palavra de alta ordem deve ser zero.

[in, optional] hInstance

Tipo: HINSTANCE

Um identificador para a instância do módulo que criou a classe .

Retornar valor

Tipo: BOOL

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

Se a classe não puder ser encontrada ou se ainda existir uma janela que foi criada com a classe , o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Antes de chamar essa função, um aplicativo deve destruir todas as janelas criadas com a classe especificada.

Todas as classes de janela registradas por um aplicativo não são registradas quando termina.

Os átomos de classe são átomos especiais retornados apenas por RegisterClass e RegisterClassEx.

Nenhuma classe de janela registrada por uma DLL será cancelada quando a .dll for descarregada.

Observação

O cabeçalho winuser.h define UnregisterClass como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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-windowclass-l1-1-0 (introduzido no Windows 8)

Confira também

Conceitual

Referência

Registerclass

Registerclassex

Classes de janela