UnregisterClassA 함수(winuser.h)

아티클
08/28/2023

창 클래스의 등록을 취소하여 클래스에 필요한 메모리를 해제합니다.

구문

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 도입)