RegisterClassExW function (winuser.h) - Win32 apps
CreateWindow 또는 CreateWindowEx 함수를 호출하기 위해 사용할 윈도우 클래스를 등록합니다.
Syntax
1
2
3
ATOM RegisterClassExA(
[in] const WNDCLASSEXA *unnamedParam1
);
Parameters
1
[in] unnamedParam1
WNDCLASSEX 구조체에 대한 포인터입니다. 함수에 이것을 전달하기 전에 반드시 구조체에 적절한 클래스 속성들(class attributes)로 채워야 합니다.
Return value
함수가 성공했다면, 리턴 값은 등록된 클래스를 유일하게 식별하는 class atom입니다. 이 atom은 오로지 CreateWindow, CreateWindowEx, GetClassInfo, GetClassInfoEx, FindWindow, FindWindowEx, 그리고 UnregisterClass 함수와 IActivelMMap::FilterClientWindows 메소드에서만 사용될 수 있습니다.
만약 함수가 실패했다면 리턴 값은 0입니다. 더 많은 오류 정보를 보려면, GetLastError 를 호출하세요.
Remarks
만약 RegisterClassExA를 사용해 윈도우 클래스를 등록한다면, 애플리케이션은 생성된 클래스의 윈도우들이 ANSI 문자열 집합을 사용하기 위해 텍스트 또는 문자 매개변수가 포함된 메세지를 기대한다고 시스템에게 알립니다. 만약 RegisterClassExW를 사용해 등록한다면, 애플리케이션은 시스템이 메세지의 텍스트 매개변수를 유니코드로 전달하도록 요청합니다. IsWindowUnicode 함수를 사용해 각 윈도우의 속성을 쿼리(query)할 수 있습니다. ANSI와 Unicode 함수에 대한 더 많은 정보를 보려면, Conventions for Function Prototypes 문서를 보세요.
애플리케이션이 등록한 모든 윈도우 클래스들은 애플리케이션이 종료될 때 모두 등록 해제됩니다.
DLL이 언로드될 때 DLL에 의해 등록된 윈도우 클래스들은 등록 해제되지 않습니다. DLL은 언로드될 때 반드시 명시적으로 DLL의 윈도우 클래스들을 등록 해제해야 합니다.
Examples
예제를 보려면, Using Window Classes 문서를 보세요.
Note: winuser.h 헤더는 RegisterClassEx를 UNICODE 전처리기 상수가 정의되어 있는지에 따라 자동으로 이 함수의 ANSI 또는 Unicode 버전을 자동으로 선택하는 별칭(alias)으로 정의합니다.