MsiSetInternalUI 함수(msi.h)

  • 아티클

MsiSetInternalUI 함수는 설치 관리자의 내부 사용자 인터페이스를 사용하도록 설정합니다. 그런 다음 이 사용자 인터페이스는 이 프로세스에서 사용자 인터페이스 생성 설치 관리자 함수에 대한 모든 후속 호출에 사용됩니다. 자세한 내용은 사용자 인터페이스 수준을 참조하세요.

구문

INSTALLUILEVEL MsiSetInternalUI(
  [in]      INSTALLUILEVEL dwUILevel,
  [in, out] HWND           *phWnd
);

매개 변수

[in] dwUILevel

사용자 인터페이스의 복잡성 수준을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
INSTALLUILEVEL_FULL
 마법사, 진행률 및 오류를 사용하여 만든 사용자 인터페이스입니다.
INSTALLUILEVEL_REDUCED
 마법사 대화 상자가 표시되지 않는 만든 사용자 인터페이스입니다.
INSTALLUILEVEL_BASIC
 단순 진행 및 오류 처리입니다.
INSTALLUILEVEL_DEFAULT
 설치 관리자는 적절한 사용자 인터페이스 수준을 선택합니다.
INSTALLUILEVEL_NONE
 완전히 자동 설치 여기에는 필요한 경우에도 권한 상승 프롬프트를 표시하지 않는 것이 포함됩니다. 사용자가 승격 할 수 있도록 하려면 INSTALLUILEVEL_UACONLY 참조하세요.
INSTALLUILEVEL_ENDDIALOG
 위의 값과 결합된 경우 설치 관리자는 설치가 성공적으로 끝나거나 오류가 발생한 경우 모달 대화 상자를 표시합니다. 사용자가 취소한 경우 대화 상자는 표시되지 않습니다.
INSTALLUILEVEL_PROGRESSONLY
 INSTALLUILEVEL_BASIC 값과 결합된 경우 설치 관리자는 간단한 진행률 대화 상자를 표시하지만 모달 대화 상자 또는 오류 대화 상자를 표시하지 않습니다.
INSTALLUILEVEL_NOCHANGE
 UI 수준은 변경되지 않습니다. 그러나 phWnd 가 Null이 아니면 부모 창이 변경됩니다.
INSTALLUILEVEL_HIDECANCEL
 INSTALLUILEVEL_BASIC 값과 결합된 경우 설치 관리자는 간단한 진행률 대화 상자를 표시하지만 대화 상자에 취소 단추를 표시하지 않습니다. 이렇게 하면 사용자가 설치를 취소할 수 없습니다.
INSTALLUILEVEL_SOURCERESONLY
 이 값이 INSTALLUILEVEL_NONE 값과 결합된 경우 설치 관리자는 원본 확인에 사용되는 대화 상자만 표시합니다. 다른 대화 상자는 표시되지 않습니다. UI 수준이 INSTALLUILEVEL_NONE 않으면 이 값은 적용되지 않습니다. 원본 확인을 제외한 모든 UI를 처리하도록 설계된 외부 사용자 인터페이스와 함께 사용됩니다. 이 경우 설치 관리자는 원본 확인을 처리합니다.
INSTALLUILEVEL_UACONLY
 INSTALLUILEVEL_NONE 값과 결합하면 필요한 경우 권한 상승 프롬프트를 제외하고 설치가 완전히 자동으로 수행됩니다.

[in, out] phWnd

창에 대한 포인터입니다. 이 창은 생성된 모든 사용자 인터페이스의 소유자가 됩니다. 사용자 인터페이스의 이전 소유자에 대한 포인터가 반환됩니다. 이 매개 변수가 null이면 사용자 인터페이스의 소유자가 변경되지 않습니다.

반환 값

이전 사용자 인터페이스 수준이 반환됩니다. 잘못된 dwUILevel 이 전달되면 INSTALLUILEVEL_NOCHANGE 반환됩니다.

설명

MsiSetInternalUI 함수는 설치 관리자가 사용자 인터페이스를 표시해야 하는 경우에 유용합니다. 예를 들어 기능이 설치되어 있지만 원본이 삽입해야 하는 컴팩트 디스크인 경우 설치 관리자가 사용자에게 컴팩트 디스크를 묻는 메시지를 표시합니다. 설치의 특성에 따라 애플리케이션은 진행률 표시기를 표시하거나 사용자에게 정보를 쿼리할 수도 있습니다.

Msi.dll 로드되면 사용자 인터페이스 수준이 DEFAULT로 설정되고 사용자 인터페이스 소유자가 0으로 설정됩니다(즉, 초기 사용자 인터페이스 소유자가 데스크톱임).

요구 사항

   
지원되는 최소 클라이언트 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 Installer 버전에 필요한 최소 Windows 서비스 팩에 대한 자세한 내용은 Windows Installer 런타임 요구 사항을 참조하세요.
대상 플랫폼 Windows
헤더 msi.h
라이브러리 Msi.lib
DLL Msi.dll

참고 항목

인터페이스 및 로깅 함수