Função UnregisterClassW (winuser.h)

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

Sintaxe

BOOL UnregisterClassW(
  [in]           LPCWSTR   lpClassName,
  [in, optional] HINSTANCE hInstance
);

Parâmetros

[in] lpClassName

Tipo: LPCTSTR

Uma cadeia de caracteres terminada em nulo ou um átomo de classe. Se lpClassName for uma cadeia de caracteres, ele especifica 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. Classes do sistema, como controles de caixa de diálogo, não podem ser não registradas. 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.

Valor de retorno

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado não será 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.

Observações

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

Todas as classes de janela que um aplicativo registra 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 não é registrada quando o .dll é descarregado.

Requisitos

Consulte também

Conceitual

de referência de

RegisterClass

RegisterClassEx

classes de janela