winuser.h


RegisterClassEx

La función RegisterClassEx registra una clase de ventana para su uso subsecuente en llamadas a las funciones CreateWindow o CreateWindowEx.

Sintaxis

ATOM RegisterClassEx(
  CONST WNDCLASSEX *lpwcx  // dirección de la estructura con datos de la clase
);

Parámetros:

lpwcx: Puntero a una estructura de tipo WNDCLASSEX. Se debe completar la estructura con los atributos de clase apropiados antes de pasarla a la función.

Valor de retorno

Si la función tiene éxito, el valor de retorno es un átomo que identifica en forma única a la clase que se registra.

Si la función falla, el valor de retorno es cero. Para obtener información extendida del error, llamar a GetLastError.

Observaciones

Si se registra la clase de ventana usando RegisterClassExA, la aplicación le dice al sistema que la ventana de la clase creada espera mensajes con texto o parámetros que usen el juego de caracteres ANSI; si se registra usando RegisterClassExW, la aplicación pide que el sistema pase los parámetros de texto en Unicode. La función IsWindowUnicode habilita a la aplicación a consultar la naturaleza de cada ventana. Para más información de las funciones ANSI y Unicode en el API de Win32, ver Prototipos de Funciones.

Todas las clases de ventana que una aplicación registra son "desregistradas" (unregistered) cuando ésta termina.

Windows 95: Todas las clases registradas por un DLL son "desregistradas" (unregistered) cuando el DLL es descargado.

Windows NT: Ninguna clase registrada por un DLL es "desregistrada" (unregistered) cuando el DLL es descargado.

Windows 95: RegisterClassEx falla si los miembros cbWndExtra o cbClsExtra of la estructura WNDCLASSEX contienen más de 40 bytes.