Export (0) Print
Expand All
Expand Minimize
2 out of 10 rated this helpful - Rate this topic

GetAncestor function

Retrieves the handle to the ancestor of the specified window.

Syntax


HWND WINAPI GetAncestor(
  _In_  HWND hwnd,
  _In_  UINT gaFlags
);

Parameters

hwnd [in]

Type: HWND

A handle to the window whose ancestor is to be retrieved. If this parameter is the desktop window, the function returns NULL.

gaFlags [in]

Type: UINT

The ancestor to be retrieved. This parameter can be one of the following values.

ValueMeaning
GA_PARENT
1

Retrieves the parent window. This does not include the owner, as it does with the GetParent function.

GA_ROOT
2

Retrieves the root window by walking the chain of parent windows.

GA_ROOTOWNER
3

Retrieves the owned root window by walking the chain of parent and owner windows returned by GetParent.

 

Return value

Type:

Type: HWND

The return value is the handle to the ancestor window.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
GetParent
Conceptual
Windows

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.