MsiEmbeddedUI テーブル

MsiEmbeddedUI テーブルは、Windows インストーラー パッケージに埋め込まれたユーザー インターフェイスを定義します。

Windows インストーラー 4.0 以前の: サポートされていません。 この表は、Windows インストーラー 4.5 以降で使用できます。

MsiEmbeddedUI テーブルには、次の列があります。

コラム	種類	鍵	許容
MsiEmbeddedUI	識別子の	Y	N
FileName	テキスト	N	N
属性	整数 の	N	N
MessageFilter	DoubleInteger を する	N	Y
データ	バイナリ の	N	N

 

列

MsiEmbeddedUI

テーブルの主キー。

FileName

データ列のバイナリ情報を受け取るファイルの名前。 拡張子を含めるには、ファイルの名前が必要です。 たとえば、名前 embeddedui.dll は許容されますが、embeddedui は許容できません。 名前はローカライズできます。 このフィールドには、短いファイル名または長いファイル名を含めることができますが、両方を含めることはできません。 このフィールドの形式は、Filename 列のデータ型に似ていますが、短いファイル名/長いファイル名構文の縦棒 (|) 区切り記号を使用できない点が異なります。 一部の Web サーバーでは大文字と小文字が区別される可能性があるため、FileName は、インターネットのダウンロードを確実にサポートするために、ソース ファイルの大文字と小文字を正確に一致させる必要があります。

属性

[データ] 列のデータに関する情報。 このフィールドの値には、次の定数のうち 1 つ以上を含めることができます。

定数	16 進 数	小数	意味
何一つ	0x00	0	ファイルは、ユーザー インターフェイスの DLL ファイルではありません。 ユーザー インターフェイスで使用されるリソース ファイルである可能性があります。
msidbEmbeddedUI を する	0x01	1	ユーザー インターフェイスのプライマリ DLL ファイル。 この属性でマークできる行は、テーブル内に複数ありません。 この属性で複数の行がマークされている場合、エラーであり、どの DLL が使用されているかを保証できません。
msidbEmbeddedHandlesBasic	0x02	2	基本的な UI レベルのインストール中に、インストーラーで埋め込み UI を呼び出すことができます。 msidbEmbeddedUI 属性と組み合わされていない場合、インストーラーはこの属性を無視します。

 

MessageFilter

ユーザー インターフェイス DLL に送信されるメッセージの種類を指定します。 この列は、msidbEmbeddedUI 属性を持つ行にのみ関連します。 行がリソース ファイルを参照し、属性の値が null の場合、このフィールドは null にする必要があります。 行がユーザー インターフェイス DLL を参照している場合、この列の値は null にすることはできません。

この列の値は、次の値の組み合わせにすることができます。 インストーラーは、その他の値を無視します。

定数	16 進 数	小数	形容
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、および戻り値が含まれています。

 

データ

この列にはバイナリ情報が含まれています。 [属性] フィールドが msidbEmbeddedUI 属性でマークされている場合、このフィールドの情報は DLL である必要があります。 属性フィールドが msidbEmbeddedUI 属性 でない場合、このフィールドの情報は任意の形式のリソース ファイルにすることができます。

備考

埋め込みユーザー インターフェイスを使用するには、セットアップ開発者がこの機能を Windows インストーラー パッケージに作成する必要があります。 MsiEmbeddedUI テーブルは、埋め込みユーザー インターフェイスを定義します。 埋め込み UI の DLL は、InitializeEmbeddedUI、EmbeddedUIHandler、および ShutdownEmbeddedUI 関数 エクスポートする必要があります。 埋め込みユーザー インターフェイスをサポートしていないパッケージでは、Windows インストーラーの内部ユーザー インターフェイスを使用できます。

埋め込みユーザー インターフェイスで Debugging Tools for Windows を実行するには、「カスタム アクション のデバッグ」で説明されている手法を使用します。 MsiBreak の値を MsiEmbeddedUI に設定します。

埋め込みカスタム UI の例については、「埋め込み UI を使用する」を参照してください。