MessageBoxIndirectA 함수(winuser.h)

아티클
08/27/2023

메시지 상자를 만들고 표시하며 작동합니다. 메시지 상자에는 애플리케이션에서 정의한 메시지 텍스트와 제목, 아이콘 및 미리 정의된 푸시 단추의 조합이 포함됩니다.

구문

int MessageBoxIndirectA(
  [in] const MSGBOXPARAMSA *lpmbp
);

매개 변수

[in] lpmbp

형식: const LPMSGBOXPARAMS

메시지 상자를 표시하는 데 사용되는 정보를 포함하는 MSGBOXPARAMS 구조체에 대한 포인터입니다.

반환 값

형식: int

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

메시지 상자에 취소 단추가 있는 경우 ESC 키를 누르거나 취소 단추를 선택한 경우 함수는 IDCANCEL 값을 반환합니다. 메시지 상자에 취소 단추가 없으면 ESC를 눌러도 아무런 효과가 없습니다.

메모리가 부족하여 메시지 상자를 만들 수 없는 경우 반환 값은 0입니다.

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

설명

시스템 모달 메시지 상자를 사용하여 시스템이 메모리 부족임을 나타내는 경우 리소스 로드 시도가 실패할 수 있으므로 MSGBOXPARAMS 구조체의 lpszText 및 lpszCaption 멤버가 가리키는 문자열을 리소스 파일에서 가져와서는 안 됩니다.

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

참고

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

요구 사항


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