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

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

Si la función se realiza 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.

Comentarios

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 anula el registro de ninguna clase de ventana registrada por un archivo DLL cuando se descarga el .dll.

Nota

El encabezado winuser.h define UnregisterClass como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-windowclass-l1-1-0 (introducido en Windows 8)

Consulte también

Conceptual

Referencia

RegisterClass

RegisterClassEx

Clases de ventanas