インストーラー関数リファレンス

  • [アーティクル]

アプリケーションで Windows インストーラーを有効にするには、インストーラー関数を使用する必要があります。 このトピックの表では、カテゴリ別に関数を識別しています。

ユーザー インターフェイスとログ関数

名前 説明
MsiSetInternalUI インストーラーの内部ユーザー インターフェイスを有効にします。
MsiSetExternalUI 文字列の形式でメッセージを受信する外部ユーザー インターフェイス ハンドラーを有効にします。
MsiSetExternalUIRecord レコード形式でメッセージを受信する外部ユーザー インターフェイス ハンドラーを有効にします。
MsiEnableLog 呼び出しプロセス内ですべてのインストールのログ モードを設定します。

 

管理機能の処理

名前 説明
MsiCloseHandle 開いているインストール ハンドルを閉じます。
MsiCloseAllHandles 開いているすべてのインストール ハンドルを閉じます。 クリーンアップには使用しないでください。

 

インストールと構成の関数

名前 説明
MsiAdvertiseProduct 製品をアドバタイズします。
MsiAdvertiseProductEx 製品をアドバタイズします。
MsiAdvertiseScript 指定された場所にアドバタイズ スクリプト ファイルをコピーします。
MsiInstallProduct アプリケーションまたはアプリケーション スイートをインストールまたは削除します。
MsiConfigureProduct アプリケーションまたはアプリケーション スイートをインストールまたは削除します。
MsiConfigureProductEx アプリケーションまたはアプリケーション スイートをインストールまたは削除します。 製品のコマンドラインを指定できます。
MsiReinstallProduct インストールを再インストールまたは修復します。
MsiConfigureFeature 機能のインストール済み状態を構成します。
MsiReinstallFeature 機能を検証または修復します。
MsiInstallMissingComponent 不足しているコンポーネントをインストールします。
MsiInstallMissingFile 不足しているファイルをインストールします。
MsiNotifySidChange ユーザー SID に対する変更を含む Windows インストーラーの内部情報を通知および更新します。 Windows インストーラー 3.1 以降で使用できます。
MsiProcessAdvertiseScript 指定された場所にアドバタイズ スクリプト ファイルを処理します。
MsiSourceListAddSource 指定されたコンテキストでパッチまたは製品のソースを追加または並べ替えます。
MsiSourceListAddSourceEx 指定されたコンテキストでパッチまたは製品のソースを追加または並べ替えます。 指定されたコンテキストに存在しないパッチのソース リストを作成します。 Windows インストーラー 3.0 で使用できます。
MsiSourceListClearSource 指定されたコンテキストで、製品またはパッチの既存のソースを削除します。 Windows インストーラー 3.0 で使用できます。
MsiSourceListClearAll 指定された製品インスタンスに対して特定のソースタイプにおける既存のソースをすべて削除します。
MsiSourceListClearAllEx 指定された製品インスタンスに対して特定のソースタイプにおける既存のソースをすべて削除します。 Windows インストーラー 3.0 で使用できます。
MsiSourceListForceResolution "LastUsedSource" プロパティとして登録されている製品またはパッチにおける現在のソースの登録を削除します。 この関数は、登録されているソース リストには影響しません。
MsiSourceListForceResolutionEx "LastUsedSource" プロパティとして登録されている製品またはパッチにおける現在のソースの登録を削除します。 この関数は、登録されているソース リストには影響しません。 Windows インストーラー 3.0 で使用できます。
MsiSourceListGetInfo 特定のコンテキストで、製品またはパッチのソース リストに関する情報を取得します。
MsiSourceListSetInfo 指定されたコンテキストで製品またはパッチに対して最後に使用されたソースを設定します。 Windows インストーラー 3.0 で使用できます。
MsiSourceListEnumMediaDisks パッチまたは製品のメディア ソースに登録されているディスクの一覧を列挙します。 Windows インストーラー 3.0 で使用できます。
MsiSourceListAddMediaDisk 登録されている製品またはパッチのメディア ソースのディスクを追加または更新します。 Windows インストーラー 3.0 で使用できます。
MsiSourceListClearMediaDisk 特定のコンテキストで、製品またはパッチのメディア ソースの下にある登録済み既存ディスクを削除します。 Windows インストーラー 3.0 で使用できます。
MsiSourceListEnumSources 指定されたパッチまたは製品のソース リスト内のソースを列挙します。 Windows インストーラー 3.0 で使用できます。

 

Component-Specific 関数

名前 説明
MsiProvideAssembly アセンブリの完全なコンポーネント パスをインストールして返します。
MsiProvideComponent コンポーネントの完全なコンポーネント パスをインストールして返します。
MsiProvideQualifiedComponent 修飾されたコンポーネントの完全なコンポーネント パスをインストールして返します。
MsiProvideQualifiedComponentEx 製品によって公開される修飾されたコンポーネントの完全なコンポーネント パスをインストールして返します。
MsiGetComponentPath インストールされているコンポーネントへの完全なパスまたはレジストリ キーを返します。
MsiGetComponentPathEx ユーザー アカウントとインストール コンテキスト全体でインストールされているコンポーネントへの完全なパスまたはレジストリ キーを返します。 Windows インストーラー 4.5 以前: サポートされていません。
MsiLocateComponent 製品コードなしでインストールされているコンポーネントへの完全なパスを返します。
MsiQueryComponentState コンポーネントのインストール済み状態を返します。 現在のユーザー以外のユーザー アカウントにインストールされている製品のインスタンスのコンポーネントに対してクエリを実行できます。 Windows インストーラー 3.0 以降で使用できます。

 

アプリケーション専用関数

名前 説明
MsiCollectUserInfo インストール ウィザードのユーザー情報を格納します。
MsiUseFeature 機能の使用回数を増やし、インストールの状態を示します。
MsiUseFeatureEx 機能の使用回数を増やし、インストールの状態を示します。
MsiGetProductCode コンポーネント コードを使用して製品コードを返します。

 

システム状態関数

名前 説明
MsiEnumProducts アドバタイズされた製品を列挙します。
MsiEnumProductsEx 指定されたコンテキストで、アドバタイズまたはインストールされている製品のすべてのインスタンスを列挙します。 Windows インストーラー 3.0 以降で使用できます。
MsiEnumRelatedProducts 指定されたアップグレード コードを持つ、現在インストールされている製品を列挙します。
MsiEnumFeatures 公開された機能を列挙します。
MsiEnumComponents インストールされているコンポーネントを列挙します。
MsiEnumComponentsEx ユーザー アカウントとインストール コンテキスト全体でインストールされているコンポーネントを列挙します。 Windows インストーラー 4.5 以前: サポートされていません。
MsiEnumClients インストールされているコンポーネントのクライアントを列挙します。
MsiEnumClientsEx ユーザー アカウントとインストール コンテキスト全体でインストールされているコンポーネントのクライアントを列挙します。 Windows インストーラー 4.5 以前: サポートされていません。
MsiEnumComponentQualifiers コンポーネントのアドバタイズされた修飾子を列挙します。
MsiQueryFeatureState 機能のインストール済み状態を返します。
MsiQueryFeatureStateEx 製品機能のインストール済み状態を返します。 現在のユーザー以外のユーザー アカウントにインストールされている製品のインスタンスの機能に対してクエリを実行できます。 Windows インストーラー 3.0 以降で使用できます。
MsiQueryProductState アプリケーションまたはアプリケーション スイートのインストール済み状態を返します。
MsiGetFeatureUsage 機能の使用状況メトリックを返します。
MsiGetProductInfo 公開され、インストールされている製品の製品情報を返します。
MsiGetProductInfoEx アドバタイズされ、インストールされている製品の製品情報を返します。 現在のユーザー以外のユーザー アカウントでインストールされている製品のインスタンスに関する情報を取得できます。 Windows インストーラー 3.0 以降で使用できます。
MsiGetUserInfo インストールされている製品の登録済みユーザー情報を返します。

 

製品クエリ関数

名前 説明
MsiOpenProduct データベースにアクセスする関数で使用する製品を開きます。
MsiOpenPackage データベースにアクセスする関数で使用するパッケージを開きます。
MsiOpenPackageEx データベースにアクセスする関数で使用するパッケージを開きます。
MsiIsProductElevated 製品が昇格された特権でインストールされているかどうかを確認します。
MsiGetProductInfoFromScript インストーラー スクリプト ファイルの製品情報を返します。
MsiGetProductProperty 製品データベースのプロパティを取得します。
MsiGetShortcutTarget ショートカットを調べて、製品、機能名、コンポーネント (使用可能な場合) を返します。
MsiGetFeatureInfo 機能の説明情報を返します。
MsiVerifyPackage 指定されたファイルがインストール パッケージであることを確認します。

 

関数の修正プログラムの適用

名前 説明
MsiApplyPatch インストールを呼び出し、パッチ パッケージを適用します。
MsiEnumPatches 製品に適用されている各パッチの GUID と、製品に適用される各パッチからの変換の一覧を返します。
MsiGetPatchInfo パッチに関する情報を返します。
MsiRemovePatches 製品からパッチをアンインストールします。 Windows インストーラー 3.0 で使用できます。
MsiDeterminePatchSequence パッチと製品のセットに最適なアプリケーション シーケンスを決定します。 Windows インストーラー 3.0 で使用できます。
MsiApplyMultiplePatches 製品に 1 つ以上のパッチを適用します。 Windows インストーラー 3.0 で使用できます。
MsiEnumPatchesEx 特定のコンテキストまたはすべてのコンテキストで製品に適用されているすべてのパッチを列挙します。 Windows インストーラー 3.0 で使用できます。
MsiGetPatchFileList .msp ファイルの一覧を指定されると、この関数は、targe の修正プログラムによって更新できるファイルの一覧を取得します。 Windows インストーラー 4.0 で使用できます。
MsiGetPatchInfoEx 指定された製品に対する指定したパッチの適用に関する情報のクエリを実行します。 Windows インストーラー 3.0 で使用できます。
MsiExtractPatchXMLData パッチから情報を抽出します。 Windows インストーラー 3.0 で使用できます。
MsiDetermineApplicablePatches 製品または製品のセットを更新するために必要なパッチの最適なセットを決定します。 Windows インストーラー 3.0 で使用できます。

 

ファイル クエリ関数

名前 説明
MsiGetFileHash ファイルへのパスを取得し、そのファイルの 128 ビット ハッシュを返します。
MsiGetFileSignatureInformation デジタル署名されたファイルへのパスを取得し、そのファイルの署名者証明書とハッシュを返します。
MsiGetFileVersion バージョン文字列と言語文字列を返します。

 

トランザクション管理機能

名前 説明
MsiBeginTransaction 複数パッケージ インストールのトランザクション処理を開始し、トランザクションの識別子を返します。 この関数は、Windows インストーラー 4.5 以降で使用できます。
MsiJoinTransaction Windows インストーラーに対して、現在のプロセスをマルチパッケージ インストールをインストールするトランザクションの所有者にするよう要求します。 この関数は、Windows インストーラー 4.5 以降で使用できます。
MsiEndTransaction トランザクションに属するすべてのインストールをコミットまたはロールバックします。 この関数は、Windows インストーラー 4.5 以降で使用できます。

 

データベース関数

前の表で示した Windows インストーラー関数に加えて、「 データベース関数 」セクションで説明されているデータベース アクセス関数を使用して、インストール データベース内の情報を操作できます。

インストーラーの構造体

さらに、インストール データベースの一部の情報は、「 インストーラーの構造体 」セクションで説明されている構造を使用して処理されます。