Función UnregisterClassA (winuser.h)

Anula el registro de una clase de ventana, liberando la memoria necesaria para la clase .

Sintaxis

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

Parámetros

[in] lpClassName

Tipo: LPCTSTR de

Cadena terminada en null o un átomo de clase. Si lpClassName es una cadena, especifica el nombre de la clase de ventana. Este nombre de clase debe haberse registrado mediante una llamada anterior a la función RegisterClass o RegisterClassEx. Las clases del sistema, como los controles de cuadro de diálogo, no se pueden anular el registro. Si este parámetro es un átomo, debe ser un átomo de clase creado por una llamada anterior a la función RegisterClass o RegisterClassEx. El átomo debe estar en la palabra de orden bajo de lpClassName; la palabra de orden superior debe ser cero.

[in, optional] hInstance

Tipo: HINSTANCE

Identificador de la instancia del módulo que creó la clase .

Valor devuelto

Tipo: BOOL de

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si no se encontró la clase o si todavía existe una ventana creada con la clase , el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Antes de llamar a esta función, una aplicación debe destruir todas las ventanas creadas con la clase especificada.

Todas las clases de ventana que registra una aplicación no se registran cuando finaliza.

Los átomos de clase son átomos especiales devueltos solo por RegisterClass y RegisterClassEx.

No se registra ninguna clase de ventana registrada por un archivo DLL cuando se descarga el .dll.

Requisitos

Consulte también

conceptual de

de referencia de

registerClass

RegisterClassEx

clases de ventana de