MessageBoxExA 함수(winuser.h)

메시지 상자를 만들고, 표시하고, 작동합니다. 메시지 상자에는 애플리케이션에서 정의한 메시지와 제목과 미리 정의된 아이콘과 누름 단추의 조합이 포함되어 있습니다. 단추는 시스템 사용자 인터페이스의 언어로 제공됩니다.

현재 MessageBoxEx 및 MessageBox 동일한 방식으로 작동합니다.

통사론

int MessageBoxExA(
  [in, optional] HWND   hWnd,
  [in, optional] LPCSTR lpText,
  [in, optional] LPCSTR lpCaption,
  [in]           UINT   uType,
  [in]           WORD   wLanguageId
);

매개 변수

[in, optional] hWnd

형식: HWND

만들 메시지 상자의 소유자 창에 대한 핸들입니다. 이 매개 변수가 NULL경우 메시지 상자에 소유자 창이 없습니다.

[in, optional] lpText

형식: LPCTSTR

표시할 메시지입니다.

[in, optional] lpCaption

형식: LPCTSTR

대화 상자 제목입니다. 이 매개 변수가 NULL경우 기본 제목 오류 사용됩니다.

[in] uType

형식: UINT

대화 상자의 내용과 동작입니다. 지원되는 플래그에 대한 자세한 내용은 MessageBox참조하세요.

[in] wLanguageId

형식: WORD

메시지 상자 단추에 표시되는 텍스트의 언어입니다. 값 0을 지정하면 단추 텍스트가 기본 시스템 언어로 표시됩니다. 이 매개 변수가 MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL)경우 호출 스레드와 연결된 현재 언어가 사용됩니다.

현재 언어 이외의 언어를 지정하려면 MAKELANGID 매크로를 사용하여 이 매개 변수를 만듭니다. 자세한 내용은 MAKELANGID참조하세요.

반환 값

형식: int

메시지 상자에 취소 단추가 있는 경우 ESC 키를 누르거나 취소 단추를 선택한 경우 함수는 IDCANCEL 값을 반환합니다. 메시지 상자에 취소 단추가 없으면 MB_OK 단추가 없는 한 ESC를 누르면 효과가 없습니다. MB_OK 단추가 표시되고 사용자가 ESC를 누르면 반환 값은 IDOK.

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

함수가 성공하면 반환 값은 다음 메뉴 항목 값 중 하나입니다.

반환 코드/값	묘사
IDABORT 3	중단 단추가 선택되었습니다.
IDCANCEL 2	취소 단추가 선택되었습니다.
IDCONTINUE 11	계속 단추가 선택되었습니다.
IDIGNORE 5	무시 단추가 선택되었습니다.
IDNO 7	없음 단추가 선택되었습니다.
IDOK 1	확인 단추가 선택되었습니다.
IDRETRY 4	다시 시도 단추가 선택되었습니다.
IDTRYAGAIN 10	다시 시도 단추가 선택되었습니다.
IDYES 6	예 단추가 선택되었습니다.

발언

시스템 모달 메시지 상자를 사용하여 시스템이 메모리가 부족함을 나타내는 경우 리소스 로드 시도가 실패할 수 있으므로 lpText 및 lpCaption 매개 변수가 가리키는 문자열을 리소스 파일에서 가져와서는 안 됩니다.

대화 상자가 있는 동안 메시지 상자를 만드는 경우 대화 상자에 대한 핸들을 hWnd 매개 변수로 사용합니다. hWnd 매개 변수는 대화 상자의 컨트롤과 같은 자식 창을 식별하면 안 됩니다.

메모

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll

참고 항목

개념

대화 상자

MAKELANGID

MessageBeep

messageBox

messageBoxIndirect

기타 리소스

참조

SetForegroundWindow