INSTALLUI_HANDLERA 콜백 함수(msi.h)
INSTALLUI_HANDLER 함수 프로토타입은 설치 관리자가 진행률 알림 및 오류 메시지를 호출하는 콜백 함수를 정의합니다. 이 함수 프로토타입의 사용에 대한 자세한 내용은 MsiSetExternalUI를 사용하여 진행률 메시지 처리에서 샘플 코드 조각을 사용할 수 있습니다.
구문
INSTALLUI_HANDLERA InstalluiHandlera;
int InstalluiHandlera(
LPVOID pvContext,
UINT iMessageType,
LPCSTR szMessage
)
{...}
매개 변수
pvContext
MsiSetExternalUI 함수에 전달된 애플리케이션 컨텍스트에 대한 포인터입니다. 이 매개 변수는 오류 검사에 사용할 수 있습니다.
iMessageType
메시지 상자 스타일 1개, 메시지 상자 아이콘 유형 1개, 기본 단추 1개, 설치 메시지 유형 1개를 조합하여 지정합니다. 이 매개 변수는 다음 중 하나여야 합니다.
| 기본 ButtonsFlag | 의미 |
|---|---|
|
첫 번째 단추가 기본 단추입니다. |
|
두 번째 단추가 기본 단추입니다. |
|
세 번째 단추가 기본 단추입니다. |
| 메시지 유형 설치Flag | 의미 |
|---|---|
|
조기 종료 |
|
형식이 지정된 오류 메시지 |
|
형식이 지정된 경고 메시지 |
|
사용자 요청 메시지입니다. |
|
로그에 대한 정보 메시지 |
|
교체하기 전에 닫아야 하는 현재 사용 중인 파일 목록입니다. |
|
유효한 원본 위치 확인 요청 |
|
교체하기 전에 닫아야 하는 현재 사용 중인 파일 목록입니다. Windows Installer 4.0부터 사용할 수 있습니다. 이 메시지에 대한 자세한 내용은 외부 UI에서 다시 시작 관리자 사용을 참조하세요. |
|
디스크 공간 부족 메시지 |
|
작업 메시지의 시작입니다. 이 메시지에는 작업 이름 및 설명이 포함됩니다. |
|
개별 작업 항목과 연결된 형식이 지정된 데이터입니다. |
|
진행률 계기 정보입니다. 이 메시지에는 지금까지의 단위 및 총 단위 수에 대한 정보가 포함됩니다. |
|
사용자 인터페이스에 대한 형식이 지정된 대화 상자 정보입니다. |
|
UI 초기화 전에 전송됨, 문자열 데이터 없음 |
|
UI 종료 후 전송됨, 문자열 데이터 없음 |
|
작성된 대화 상자 또는 마법사를 표시하기 전에 전송됨 |
|
제품을 설치하기 전에 전송됩니다. |
|
제품을 설치한 후 전송됩니다. |
앞의 메시지가 누락된 경우 MB_OK, 아이콘 없음 및 MB_DEFBUTTON1 기본값을 사용해야 합니다. 기본 설치 메시지 유형은 없습니다. 메시지 유형은 항상 지정됩니다.
szMessage
메시지 텍스트를 지정합니다.
반환 값
다음 반환 값은 메시지 상자 스타일로 지정된 단추에 매핑됩니다.
IDOK
설명
외부 사용자 인터페이스 처리기에서 값을 반환하는 방법에 대한 자세한 내용은 외부 사용자 인터페이스 처리기에서 값 반환 항목을 참조하세요.
참고
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 |