GetParent 함수(winuser.h)

아티클
03/04/2024

지정된 창의 부모 또는 소유자에 대한 핸들을 검색합니다.

지정된 상위 항목에 대한 핸들을 검색하려면 GetAncestor 함수를 사용합니다.

구문

HWND GetParent(
  [in] HWND hWnd
);

매개 변수

[in] hWnd

형식: HWND

부모 창 핸들을 검색할 창에 대한 핸들입니다.

반환 값

형식: HWND

창이 자식 창인 경우 반환 값은 부모 창에 대한 핸들입니다. 창이 WS_POPUP 스타일이 있는 최상위 창인 경우 반환 값은 소유자 창에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

이 함수는 일반적으로 다음 이유 중 하나로 인해 실패합니다.

창은 소유하지 않았거나 WS_POPUP 스타일이 없는 최상위 창입니다.
소유자 창에는 WS_POPUP 스타일이 있습니다.

설명

창의 소유자 창을 가져오려면 GetParent를 사용하는 대신 GW_OWNER 플래그와 함께 GetWindow를 사용합니다. GetParent를 사용하는 대신 소유자가 아닌 부모 창을 가져오려면 GA_PARENT 플래그와 함께 GetAncestor를 사용합니다.

예제

예제는 대화 상자 초기화를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-0(Windows 8 도입)