FindWindowA 함수(winuser.h)

아티클
08/27/2023

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

자식 창을 검색하려면 지정된 자식 창부터 FindWindowEx 함수를 사용합니다.

구문

HWND FindWindowA(
  [in, optional] LPCSTR lpClassName,
  [in, optional] LPCSTR lpWindowName
);

매개 변수

[in, optional] lpClassName

형식: LPCTSTR

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

lpClassName이 문자열을 가리키는 경우 창 클래스 이름을 지정합니다. 클래스 이름은 RegisterClass 또는 RegisterClassEx에 등록된 이름 또는 미리 정의된 컨트롤 클래스 이름일 수 있습니다.

lpClassName이 NULL이면 타이틀이 lpWindowName 매개 변수와 일치하는 창을 찾습니다.

[in, optional] lpWindowName

형식: LPCTSTR

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

반환 값

형식: HWND

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

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

설명

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

예제

예를 들어 마우스 휠 스크롤 줄 수 검색을 참조하세요.

참고

winuser.h 헤더는 FINDWindow를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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-0(Windows 8에서 도입)