Share via

INSTALLUI_HANDLER_RECORD 콜백 함수(msi.h)

  • 아티클

INSTALLUI_HANDLER_RECORD 함수 프로토타입은 설치 관리자가 진행률 알림 및 오류 메시지를 호출하는 콜백 함수를 정의합니다. MsiSetExternalUIRecord 함수를 호출하여 레코드 기반 UI(외부 사용자 인터페이스) 처리기를 사용하도록 설정합니다.

Windows Installer 3.0 및 Windows Installer 2.0: 지원되지 않습니다. Windows Installer 버전 3.1 이상부터 사용할 수 있습니다.

구문

INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;

int InstalluiHandlerRecord(
  LPVOID pvContext,
  UINT iMessageType,
  MSIHANDLE hRecord
)
{...}

매개 변수

pvContext

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

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 기본값을 사용해야 합니다. 기본 설치 메시지 유형은 없습니다. 메시지 유형은 항상 지정됩니다.

hRecord

레코드 개체에 대한 핸들을 지정합니다. 레코드 개체에 대한 자세한 내용은 레코드 처리 함수를 참조하세요.

반환 값

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

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

설명

이 유형의 외부 UI 처리기는 호출자가 관심 있는 오류 또는 메시지의 유형을 알고 있고 INSTALLUI_HANDLER 형식의 외부 UI 처리기로 전송되는 문자열 메시지를 구문 분석하는 오버헤드를 방지하되 hRecord 필드에서 관심 있는 데이터를 검색하려는 경우에 사용해야 합니다.

외부 사용자 인터페이스 처리기에서 값을 반환하는 방법에 대한 자세한 내용은 외부 사용자 인터페이스 처리기에서 값 반환 항목을 참조하세요. 레코드 기반 외부 UI 처리기로 전송된 hRecord 개체는 Windows Installer에서 소유하며 콜백의 수명 동안만 유효합니다. 콜백은 레코드에서 필요한 모든 데이터를 추출해야 하며 해당 핸들을 닫지 않아야 합니다.

레코드 기반 외부 UI 처리기가 hRecord 개체의 데이터를 변경하려는 시도는 Windows Installer에서 무시됩니다.

레코드 기반 외부 처리기 사용에 대한 자세한 내용은 MsiSetExternalUIRecord를 사용하여 설치 모니터링을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 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 3.1.
대상 플랫폼 Windows
헤더 msi.h

추가 정보

MsiSetExternalUI

Windows Installer 3.0 이하에서 지원되지 않음