다음을 통해 공유

MsiEmbeddedUI 테이블

  • 아티클

MsiEmbeddedUI 테이블은 Windows Installer 패키지에 포함되는 사용자 인터페이스를 정의합니다.

Windows Installer 4.0 이하: 지원되지 않습니다. 이 테이블은 Windows Installer 4.5부터 사용할 수 있습니다.

MsiEmbeddedUI 테이블에는 다음과 같은 열이 있습니다.

Column 형식 키 Nullable
MsiEmbeddedUI 식별자 Y N
FileName Text N N
특성 정수 N N
MessageFilter DoubleInteger N Y
데이터 이진 N N

 

열

MsiEmbeddedUI

테이블의 기본 키입니다.

FileName

Data 열에서 이진 정보를 수신하는 파일의 이름입니다. 확장명을 포함하려면 파일 이름이 필요합니다. 예를 들어 embeddedui.dll이라는 이름은 허용되지만 embeddedui는 허용되지 않습니다. 이름은 지역화될 수 있습니다. 이 필드는 짧은 파일 이름 또는 긴 파일 이름을 포함할 수 있지만 둘 다 포함할 수는 없습니다. 이 필드의 형식은 짧은 파일 이름/긴 파일 이름 구문에 세로 막대(|) 구분 기호를 사용할 수 없다는 점을 제외하고 Filename 열의 데이터 형식과 같습니다. 일부 웹 서버는 대/소문자를 구분하므로 FileName이 원본 파일의 대/소문자와 정확하게 일치해야 인터넷 다운로드가 지원됩니다.

Attributes

Data 열의 데이터에 대한 정보입니다. 이 필드의 값에는 다음 상수 중 하나 이상이 포함될 수 있습니다.

상수 16진수 Decimal 의미
None 0x00 0 파일은 사용자 인터페이스에 대한 DLL 파일이 아닙니다. 사용자 인터페이스에서 사용하는 리소스 파일일 수 있습니다.
msidbEmbeddedUI 0x01 1 사용자 인터페이스의 기본 DLL 파일입니다. 이 특성으로 테이블의 행을 두 개 이상 표시할 수 없습니다. 여러 행이 이 특성으로 표시된 경우 오류이며 어떤 DLL이 사용되는지 보장할 수 없습니다.
msidbEmbeddedHandlesBasic 0x02 2 설치 관리자가 기본 UI 수준 설치 중에 포함된 UI를 호출할 수 있도록 합니다. msidbEmbeddedUI 특성과 함께 사용되지 않은 경우 설치 관리자는 이 특성을 무시합니다.

 

MessageFilter

사용자 인터페이스 DLL로 전송되는 메시지 유형을 지정합니다. 이 열은 msidbEmbeddedUI 특성이 있는 행에만 해당합니다. 행이 리소스 파일을 참조하고 특성 값이 null인 경우 이 필드는 null이어야 합니다. 행이 사용자 인터페이스 DLL을 참조하는 경우 이 열의 값은 null이어서는 안 됩니다.

이 열의 값은 다음 값의 조합일 수 있습니다. 설치 관리자는 다른 값을 무시합니다.

상수 16진수 Decimal 설명
INSTALLLOGMODE_FATALEXIT 0x00001 1 조기 종료되었습니다.
INSTALLLOGMODE_ERROR 0x00002 2 오류 메시지.
INSTALLLOGMODE_WARNING 0x00004 4 경고 메시지입니다.
INSTALLLOGMODE_USER 0x00008 8 사용자 메시지입니다.
INSTALLLOGMODE_INFO 0x00010 16 기록되지 않은 상태 메시지입니다.
INSTALLLOGMODE_FILESINUSE 0x00020 32 현재 사용 중인 파일입니다.
INSTALLLOGMODE_RESOLVESOURCE 0x00040 64 원본 확인 요청입니다.
INSTALLLOGMODE_OUTOFDISKSPACE 0x00080 128 디스크 공간 메시지입니다.
INSTALLLOGMODE_ACTIONSTART 0x00100 256 작업 시작 메시지입니다.
INSTALLLOGMODE_ACTIONDATA 0x00200 512 작업 데이터 메시지입니다.
INSTALLLOGMODE_PROGRESS 0x00400 1024 진행률 메시지입니다.
INSTALLLOGMODE_COMMONDATA 0x00800 2048 UI 초기화 메시지입니다.
INSTALLLOGMODE_INITIALIZE 0x01000 4096 제품 설치가 시작될 때 전송되는 UI 시작 메시지입니다.
INSTALLLOGMODE_TERMINATE 0x02000 8192 제품 설치가 완료된 후 전송되는 UI 종료 메시지입니다.
INSTALLLOGMODE_SHOWDIALOG 0x04000 16384 UI 대화 상자가 표시되기 전에 보내는 메시지입니다.
INSTALLLOGMODE_RMFILESINUSE 0x02000000 33554432 현재 사용 중인 파일입니다.
INSTALLLOGMODE_INSTALLSTART 0x04000000 67108864 제품 설치가 시작됩니다. 메시지에는 제품의 ProductName 및 ProductCode가 포함됩니다.
INSTALLLOGMODE_INSTALLEND 0x08000000 134217728 제품 설치가 종료됩니다. 메시지에는 제품의 ProductName, ProductCode 및 반환 값이 포함됩니다.

 

Data

이 열에는 이진 정보가 포함됩니다. Attribute 필드가 msidbEmbeddedUI 특성으로 표시된 경우 이 필드의 정보는 DLL이어야 합니다. Attribute 필드가 msidbEmbeddedUI 특성이 아닌 경우 이 필드의 정보는 모든 형식의 리소스 파일일 수 있습니다.

설명

포함된 사용자 인터페이스를 사용하려면 설치 개발자가 이 기능을 Windows Installer 패키지에 작성해야 합니다. MsiEmbeddedUI 테이블은 포함된 사용자 인터페이스를 정의합니다. 포함된 UI의 DLL은 InitializeEmbeddedUI, EmbeddedUIHandler 및 ShutdownEmbeddedUI 함수를 내보내야 합니다. 포함된 사용자 인터페이스를 지원하지 않는 패키지는 Windows Installer 내부 사용자 인터페이스를 사용할 수 있습니다.

포함된 사용자 인터페이스에서 Windows용 디버깅 도구를 실행하려면 사용자 지정 작업 디버깅에 설명된 기술을 사용합니다. MsiBreak의 값을 MsiEmbeddedUI로 설정합니다.

포함된 사용자 지정 UI의 예제는 포함된 UI 사용을 참조하세요.