EnumWindows 함수(winuser.h)

각 창에 핸들을 차례로 애플리케이션 정의 콜백 함수에 전달하여 화면의 모든 최상위 창을 열거합니다. EnumWindows는 마지막 최상위 창이 열거되거나 콜백 함수가 FALSE를 반환할 때까지 계속됩니다.

구문

BOOL EnumWindows(
  [in] WNDENUMPROC lpEnumFunc,
  [in] LPARAM      lParam
);

[in] lpEnumFunc

형식: WNDENUMPROC

애플리케이션 정의 콜백 함수에 대한 포인터입니다. 자세한 내용은 EnumWindowsProc을 참조하세요.

[in] lParam

형식: LPARAM

콜백 함수에 전달할 애플리케이션 정의 값입니다.

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

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

EnumWindowsProc이 0을 반환하면 반환 값도 0입니다. 이 경우 콜백 함수는 SetLastError 를 호출하여 EnumWindows 호출자에게 반환할 의미 있는 오류 코드를 가져와야 합니다.

EnumWindows 함수는 WS_CHILD 스타일을 가진 시스템에서 소유한 몇 가지 최상위 창을 제외하고 자식 창을 열거하지 않습니다.

이 함수는 루프에서 GetWindow 함수를 호출하는 것보다 더 안정적입니다. GetWindow를 호출하여 이 작업을 수행하는 애플리케이션은 무한 루프에서 잡히거나 제거된 창에 대한 핸들을 참조할 위험이 있습니다.

참고 Windows 8 이상의 경우 EnumWindows는 데스크톱 앱의 최상위 창만 열거합니다.

요구 사항	값
지원되는 최소 클라이언트	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 도입)