UnregisterClassA 함수(winuser.h)
창 클래스의 등록을 취소하여 클래스에 필요한 메모리를 해제합니다.
구문
BOOL UnregisterClassA(
[in] LPCSTR lpClassName,
[in, optional] HINSTANCE hInstance
);
매개 변수
[in] lpClassName
형식: LPCTSTR
null로 끝나는 문자열 또는 클래스 원자입니다. lpClassName이 문자열인 경우 창 클래스 이름을 지정합니다. 이 클래스 이름은 RegisterClass 또는 RegisterClassEx 함수에 대한 이전 호출에 의해 등록 되어 있어야 합니다. 대화 상자 컨트롤과 같은 시스템 클래스는 등록을 취소할 수 없습니다. 이 매개 변수가 atom인 경우 RegisterClass 또는 RegisterClassEx 함수에 대한 이전 호출에서 만든 클래스 원자여야 합니다. 원자는 lpClassName의 낮은 순서 단어에 있어야 합니다. 상위 단어는 0이어야 합니다.
[in, optional] hInstance
형식: HINSTANCE
클래스를 만든 모듈의 instance 대한 핸들입니다.
반환 값
형식: BOOL
함수가 성공하면 반환 값이 0이 아닙니다.
클래스를 찾을 수 없거나 클래스를 사용하여 만든 창이 여전히 있는 경우 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
이 함수를 호출하기 전에 애플리케이션은 지정된 클래스를 사용하여 만든 모든 창을 삭제해야 합니다.
애플리케이션이 등록하는 모든 창 클래스는 종료될 때 등록 취소됩니다.
클래스 원자는 RegisterClass 및 RegisterClassEx 에서만 반환되는 특수 원자 입니다.
.dll 언로드될 때 DLL에 의해 등록된 창 클래스가 등록 취소되지 않습니다.
참고
winuser.h 헤더는 UNREgisterClass를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | winuser.h(Windows.h 포함) |
라이브러리 | User32.lib |
DLL | User32.dll |
API 세트 | ext-ms-win-ntuser-windowclass-l1-1-0(Windows 8 도입) |
추가 정보
개념
참조