다음을 통해 공유

INSTALLUI_HANDLERW 콜백 함수(msi.h)

  • 아티클

INSTALLUI_HANDLER 함수 프로토타입은 설치 관리자가 진행률 알림 및 오류 메시지를 호출하는 콜백 함수를 정의합니다. 이 함수 프로토타입의 사용에 대한 자세한 내용은 MsiSetExternalUI를 사용하여 진행률 메시지 처리에서 샘플 코드 조각을 사용할 수 있습니다.

구문

INSTALLUI_HANDLERW InstalluiHandlerw;

int InstalluiHandlerw(
  LPVOID pvContext,
  UINT iMessageType,
  LPCWSTR szMessage
)
{...}

매개 변수

pvContext

MsiSetExternalUI 함수에 전달된 애플리케이션 컨텍스트에 대한 포인터입니다. 이 매개 변수는 오류 검사에 사용할 수 있습니다.

iMessageType

메시지 상자 스타일 1개, 메시지 상자 아이콘 유형 1개, 기본 단추 1개, 설치 메시지 유형 1개를 조합하여 지정합니다. 이 매개 변수는 다음 중 하나여야 합니다.

메시지 상자 스타일플래그 의미
MB_ABORTRETRYIGNORE
 메시지 상자에는 중단, 다시 시도 및 무시 단추가 포함되어 있습니다.
MB_OK
 메시지 상자에 는 확인 단추가 포함되어 있습니다. 이것이 기본값입니다.
MB_OKCANCEL
 메시지 상자에 는 확인 및 취소 단추가 포함되어 있습니다.
MB_RETRYCANCEL
 메시지 상자에 는 다시 시도 및 취소 단추가 포함되어 있습니다.
MB_YESNO
 메시지 상자에는 예 및 아니요 단추가 포함되어 있습니다.
MB_YESNOCANCEL
 메시지 상자에는 예, 아니요 및 취소 단추가 포함되어 있습니다.
 
메시지 상자 IconTypesFlag 의미
MB_ICONEXCLAMATION, MB_ICONWARNING
 메시지 상자에 느낌표가 나타납니다.
MB_ICONINFORMATION, MB_ICONASTERISK
 메시지 상자에 정보 기호가 나타납니다.
MB_ICONQUESTION
 메시지 상자에 물음표가 나타납니다.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
 메시지 상자에 중지 기호가 나타납니다.
 
기본 ButtonsFlag 의미
MB_DEFBUTTON1
 첫 번째 단추가 기본 단추입니다.
MB_DEFBUTTON2
 두 번째 단추가 기본 단추입니다.
MB_DEFBUTTON3
 세 번째 단추가 기본 단추입니다.
 
메시지 유형 설치Flag 의미
INSTALLMESSAGE_FATALEXIT
 조기 종료
INSTALLMESSAGE_ERROR
 형식이 지정된 오류 메시지
INSTALLMESSAGE_WARNING
 형식이 지정된 경고 메시지
INSTALLMESSAGE_USER
 사용자 요청 메시지입니다.
INSTALLMESSAGE_INFO
 로그에 대한 정보 메시지
INSTALLMESSAGE_FILESINUSE
 교체하기 전에 닫아야 하는 현재 사용 중인 파일 목록입니다.
INSTALLMESSAGE_RESOLVESOURCE
 유효한 원본 위치 확인 요청
INSTALLMESSAGE_RMFILESINUSE
 교체하기 전에 닫아야 하는 현재 사용 중인 파일 목록입니다. Windows Installer 4.0부터 사용할 수 있습니다. 이 메시지에 대한 자세한 내용은 외부 UI에서 다시 시작 관리자 사용을 참조하세요.
INSTALLMESSAGE_OUTOFDISKSPACE
 디스크 공간 부족 메시지
INSTALLMESSAGE_ACTIONSTART
 작업 메시지의 시작입니다. 이 메시지에는 작업 이름 및 설명이 포함됩니다.
INSTALLMESSAGE_ACTIONDATA
 개별 작업 항목과 연결된 형식이 지정된 데이터입니다.
INSTALLMESSAGE_PROGRESS
 진행률 계기 정보입니다. 이 메시지에는 지금까지의 단위 및 총 단위 수에 대한 정보가 포함됩니다.
INSTALLMESSAGE_COMMONDATA
 사용자 인터페이스에 대한 형식이 지정된 대화 상자 정보입니다.
INSTALLMESSAGE_INITIALIZE
 UI 초기화 전에 전송됨, 문자열 데이터 없음
INSTALLMESSAGE_TERMINATE
 UI 종료 후 전송됨, 문자열 데이터 없음
INSTALLMESSAGE_SHOWDIALOG
 작성된 대화 상자 또는 마법사를 표시하기 전에 전송됨
INSTALLMESSAGE_INSTALLSTART
 제품을 설치하기 전에 전송됩니다.
INSTALLMESSAGE_INSTALLEND
 제품을 설치한 후 전송됩니다.
 
 

앞의 메시지가 누락된 경우 MB_OK, 아이콘 없음 및 MB_DEFBUTTON1 기본값을 사용해야 합니다. 기본 설치 메시지 유형은 없습니다. 메시지 유형은 항상 지정됩니다.

szMessage

메시지 텍스트를 지정합니다.

반환 값

다음 반환 값은 메시지 상자 스타일로 지정된 단추에 매핑됩니다.

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

설명

외부 사용자 인터페이스 처리기에서 값을 반환하는 방법에 대한 자세한 내용은 외부 사용자 인터페이스 처리기에서 값 반환 항목을 참조하세요.

참고

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Server 2012, Windows 8, Windows Server 2008 R2 또는 Windows 7의 Windows Installer 5.0. Windows Server 2008 또는 Windows Vista의 Windows Installer 4.0 또는 Windows Installer 4.5. Windows Server 2003 또는 Windows XP의 Windows Installer
대상 플랫폼 Windows
헤더 msi.h

추가 정보

MsiSetExternalUI