Función RegisterClassA (winuser.h)

Registra una clase de ventana para su uso posterior en llamadas a la función CreateWindow o CreateWindowEx.

Sintaxis

ATOM RegisterClassA(
  [in] const WNDCLASSA *lpWndClass
);

Parámetros

[in] lpWndClass

Tipo: const WNDCLASS*

Puntero a una estructura WNDCLASS. Debe rellenar la estructura con los atributos de clase adecuados antes de pasarla a la función.

Valor devuelto

Tipo: atom de

Si la función se ejecuta correctamente, el valor devuelto es un átomo de clase que identifica de forma única la clase que se está registrando. El CreateWindow, CreateWindowEx, GetClassInfo, GetClassInfoEx, las funciones FindWindow, FindWindowExy unregisterClass y el método IActiveIMMap::FilterClientWindows.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Si registra la clase de ventana mediante RegisterClassA, la aplicación indica al sistema que las ventanas de la clase creada esperan mensajes con parámetros de texto o caracteres para usar el juego de caracteres ANSI; si lo registra mediante RegisterClassW, la aplicación solicita que el sistema pase parámetros de texto de mensajes como Unicode. La función isWindowUnicode permite a las aplicaciones consultar la naturaleza de cada ventana. Para obtener más información sobre las funciones ANSI y Unicode, vea Conventions for Function Prototypes.

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

No se registra ninguna clase de ventana registrada por un archivo DLL cuando se descarga el archivo DLL. Un archivo DLL debe anular explícitamente el registro de sus clases cuando se descarga.

Ejemplos

Para obtener un ejemplo, vea Asociar un procedimiento de ventana con una clase Window.

Requisitos

Consulte también

conceptual de

createWindow

createWindowEx

FindWindow

FindWindowEx

GetClassInfo

GetClassInfoEx

GetClassName

de referencia de

RegisterClassEx

unregisterClass

WNDCLASS

clases de ventana de

WindowProc