FindWindowExA 함수(winuser.h)

아티클
02/01/2024

클래스 이름과 창 이름이 지정된 문자열과 일치하는 창에 대한 핸들을 검색합니다. 함수는 지정된 자식 창 다음에 있는 자식 창부터 시작하여 자식 창을 검색합니다. 이 함수는 대/소문자를 구분하는 검색을 수행하지 않습니다.

구문

HWND FindWindowExA(
  [in, optional] HWND   hWndParent,
  [in, optional] HWND   hWndChildAfter,
  [in, optional] LPCSTR lpszClass,
  [in, optional] LPCSTR lpszWindow
);

매개 변수

[in, optional] hWndParent

형식: HWND

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

hwndParent가 NULL인 경우 함수는 데스크톱 창을 부모 창으로 사용합니다. 함수는 바탕 화면의 자식 창인 창 사이에서 검색합니다.

hwndParent가 HWND_MESSAGE 경우 함수는 모든 메시지 전용 창을 검색합니다.

[in, optional] hWndChildAfter

형식: HWND

자식 창에 대한 핸들입니다. 검색은 Z 순서의 다음 자식 창으로 시작됩니다. 자식 창은 하위 창이 아니라 hwndParent의 직접 자식 창이어야 합니다.

hwndChildAfter가 NULL이면 hwndParent의 첫 번째 자식 창으로 검색이 시작됩니다.

hwndParent와 hwndChildAfter가 모두 NULL인 경우 함수는 모든 최상위 및 메시지 전용 창을 검색합니다.

[in, optional] lpszClass

형식: LPCSTR

RegisterClass 또는 RegisterClassEx 함수에 대한 이전 호출에서 만든 클래스 이름 또는 클래스 원 자입니다. 원자는 lpszClass의 낮은 순서 단어에 배치되어야 합니다. 상위 단어는 0이어야 합니다.

lpszClass가 문자열인 경우 창 클래스 이름을 지정합니다. 클래스 이름은 RegisterClass 또는 RegisterClassEx에 등록된 이름 또는 미리 정의된 컨트롤 클래스 이름이거나 일 수 있습니다MAKEINTATOM(0x8000). 이 후자의 경우 0x8000 메뉴 클래스의 원자입니다. 자세한 내용은 이 항목의 ‘주의’ 섹션을 참조하세요.

[in, optional] lpszWindow

형식: LPCSTR

창 이름(창의 제목)입니다. 이 매개 변수가 NULL이면 모든 창 이름이 일치합니다.

반환 값

형식: HWND

함수가 성공하면 반환 값은 지정된 클래스와 창 이름을 가진 창에 대한 핸들입니다.

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

설명

FindWindowEx 함수는 직접 자식 창만 검색합니다. 다른 하위 항목을 검색하지 않습니다.

lpszWindow 매개 변수가 NULL이 아닌 경우 FindWindowEx는 GetWindowText 함수를 호출하여 비교를 위해 창 이름을 검색합니다. 발생할 수 있는 잠재적인 문제에 대한 설명은 GetWindowText의 설명 섹션을 참조하세요.

애플리케이션은 다음 방법으로 이 함수를 호출할 수 있습니다.

FindWindowEx( NULL, NULL, MAKEINTATOM(0x8000), NULL );

0x8000 메뉴 클래스의 원자입니다. 애플리케이션이 이 함수를 호출할 때 함수는 애플리케이션이 만든 상황에 맞는 메뉴가 표시되는지 여부를 확인합니다.

참고

winuser.h 헤더는 FINDWindowEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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