다음을 통해 공유


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, EmbeddedUIHandlerShutdownEmbeddedUI 함수를 내보내야 합니다. 포함된 사용자 인터페이스를 지원하지 않는 패키지는 Windows Installer 내부 사용자 인터페이스를 사용할 수 있습니다.

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

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