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 사용을 참조하세요.