Función GetParent (winuser.h)

Artículo
03/04/2024

Recupera un identificador para el propietario o primario de la ventana especificada.

Para recuperar un identificador de un antecesor especificado, use la función GetAncestor .

Sintaxis

HWND GetParent(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana cuyo identificador de ventana principal se va a recuperar.

Valor devuelto

Tipo: HWND

Si la ventana es una ventana secundaria, el valor devuelto es un identificador de la ventana primaria. Si la ventana es una ventana de nivel superior con el estilo WS_POPUP , el valor devuelto es un identificador de la ventana del propietario.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Normalmente, se produce un error en esta función por uno de los siguientes motivos:

La ventana es una ventana de nivel superior que no está o no tiene el estilo WS_POPUP .
La ventana del propietario tiene WS_POPUP estilo.

Comentarios

Para obtener la ventana de propietario de una ventana, en lugar de usar GetParent, use GetWindow con la marca GW_OWNER . Para obtener la ventana primaria y no el propietario, en lugar de usar GetParent, use GetAncestor con la marca GA_PARENT .

Ejemplos

Para obtener un ejemplo, vea Inicializar un cuadro de diálogo.

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 (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)