winuser.h


GetWindowLong

La función GetWindowLong recupera información sobre la ventana especificada. La función también recupera el valor de 32 bits (long) en el desplazamiento especidicado dentro de la memoria extra de ventana para la ventana.

Sintaxis

LONG GetWindowLong(
    HWND hWnd,	// manipulador de ventana
    int nIndex 	// desplazamiento del valor a recuperar
   );

Parámetros:

hWnd: identifica la ventana e, indirectamente, la clase a la que pertenece.

nIndex: especifica el desplazamiento, empezando en cero, del valor a recuperar. Los valores válidos están en el rango desde cero hasta el número de bytes de memoria extra de la ventana, menos cuatro; por ejemplo, si se especifican 12 o más bytes de memoria extra, un valor de 8 será un índice para el tercer entero de 32 bits. Para recuperar cualquier otro valor, especificar uno de los valores siguientes:

Valor Acción
GWL_EXSTYLE Recupera los estilos extendidos de la ventana.
GWL_STYLE Recupera los estilos de ventana.
GWL_WNDPROC Recupera la dirección del procedimiento de ventana, o un manipulador que representa la dirección del procedimiento de ventana. Se debe usar la función CallWindowProc para invocar al procedimiento de ventana.
GWL_HINSTANCE Recupera el manipulador de la instancia de la aplicación.
GWL_HWNDPARENT Recupera el manipulador de la ventana pacre, si existe.
GWL_ID Recupera el identificador de la ventana.
GWL_USERDATA Recupera el valor de 32 bits asociado con la ventana. Cada ventana tiene su correspondiente valor de 32 bits destinado al uso por la aplicación que creó la ventana.

Los siguientes valores también están disponibles cuando el parámetro hWnd identifica un cuadro de diálogo:

Valor Acción
DWL_DLGPROC Recupera la dirección del procedimiento del cuadro de diálogo, o un manipulador que representa la dirección del procedimiento del cuadro de diálogo. Se debe usar la función CallWindowProc para invocar el procedimiento del cuadro de diálogo.
DWL_MSGRESULT Recupera el valor de retorno de un mensaje procesado en el procedimiento de cuadro de diálogo.
DWL_USER Recupera información privada extra para la aplicación, como son manipuladores o punteros.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el valor de 32 bits pedido.

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

Observaciones

Para reservar memoria extra para la ventana se debe especificar un valor distinto de cero en el miembro cbWndExtra de la estructura WNDCLASS usada con la función RegisterClass.