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