FindWindowA 함수(winuser.h)
클래스 이름과 창 이름이 지정된 문자열과 일치하는 최상위 창에 대한 핸들을 검색합니다. 이 함수는 자식 창을 검색하지 않습니다. 이 함수는 대/소문자를 구분하는 검색을 수행하지 않습니다.
자식 창을 검색하려면 지정된 자식 창부터 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입니다. 이 함수는 마지막 오류 값을 수정하지 않습니다.
설명
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에서 도입) |
추가 정보
개념
참조