RegisterWindowMessageA 함수(winuser.h)

아티클
03/04/2024

시스템 전체에서 고유하도록 보장되는 새 창 메시지를 정의합니다. 메시지 값은 메시지를 보내거나 게시할 때 사용할 수 있습니다.

구문

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

매개 변수

[in] lpString

형식: LPCTSTR

등록할 메시지입니다.

반환 값

형식: UINT

메시지가 성공적으로 등록되면 반환 값은 0xFFFF 통해 0xC000 범위의 메시지 식별자입니다.

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

설명

RegisterWindowMessage 함수는 일반적으로 두 개의 협력 애플리케이션 간에 통신하기 위한 메시지를 등록하는 데 사용됩니다.

두 개의 다른 애플리케이션이 동일한 메시지 문자열을 등록하는 경우 애플리케이션은 동일한 메시지 값을 반환합니다. 메시지는 세션이 끝날 때까지 등록된 상태로 유지됩니다.

둘 이상의 애플리케이션이 동일한 메시지를 처리해야 하는 경우에만 RegisterWindowMessage 를 사용합니다. 창 클래스 내에서 프라이빗 메시지를 보내기 위해 애플리케이션은 0x7FFF 통해 WM_USER 범위의 정수로 사용할 수 있습니다. (이 범위의 메시지는 애플리케이션이 아닌 창 클래스에 비공개입니다. 예를 들어 BUTTON, EDIT, LISTBOX 및 COMBOBOX 와 같은 미리 정의된 컨트롤 클래스는 이 범위의 값을 사용할 수 있습니다.)

예제

예제는 텍스트 찾기를 참조하세요.

참고

winuser.h 헤더는 REGISTERWindowMessage를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-message-l1-1-0(Windows 8 도입)