Installer.ApplyPatch メソッド

  • [アーティクル]

パッチを受け取る対象としてパッチ パッケージによって一覧表示されている各製品について、Installer オブジェクトの ApplyPatch メソッドでインストールを呼び出し、PATCH プロパティをパッチ パッケージのパスに設定します。

構文

Installer.ApplyPatch(
  PatchPackage,
  InstallPackage,
  InstallType,
  CommandLine
)

パラメーター

PatchPackage

パッチ パッケージへのパスを指定します。

InstallPackage

"InstallType" が msiInstallTypeNetworkImage に設定されている場合、"InstallPackage" はパッチを適用する製品へのパスを指定します。 InstallType が msiInstallTypeDefault に設定され、InstallPackage が 0 に設定されている場合、インストーラーではパッチ パッケージに記載されているすべての対象製品にパッチを適用します。

InstallType が msiInstallTypeSingleInstance の場合、インストーラーでは InstallPackage で指定された製品にパッチを適用します。 この場合、パッチ パッケージに一覧表示されている他の対象製品は無視され、InstallPackage パラメーターには、パッチを適用するインスタンスの製品コードを表す null で終わる文字列が含まれています。 この種類のインストールには、Windows Server 2003 以降または Windows インストーラー XP SP1 以降に付属している Windows インストーラーのバージョンが必要です。

InstallType

このパラメーターでは、パッチを適用するインストールの種類を指定します。 InstallPackage を省略した場合、InstallType パラメーターは無視されます。

値 説明
msiInstallTypeNetworkImage
 管理インストールを指定します。 この場合、InstallPackage はパッケージ パスに設定する必要があります。 msiInstallTypeNetworkImage の値 1 は、管理インストールを指定します。
msiInstallTypeDefault
 パッチを適用する製品をシステムで検索します。 この場合、InstallPackage は 空の文字列である必要があります。
msiInstallSingleInstance
 InstallPackage で指定された製品にパッチを適用します。 InstallPackage は、パッチを適用するインスタンスの製品コードです。 この種類のインストールには、Windows Server 2003 以降または Windows インストーラー XP SP1 以降に付属している Windows インストーラーのバージョンが必要です。 詳細については、「製品とパッチの複数のインスタンスをインストールする」を参照してください。

 

CommandLine

コマンド ラインで設定するプロパティ設定を指定します。 「解説」を参照してください。

戻り値

このメソッドは値を返しません。

解説

変換、ソース、パッチのリスト区切り記号はセミコロンであるため、この文字はファイル名やパスには使用しないでください。

小規模な更新プログラムまたはマイナー アップグレードのパッチを適用する場合は、REINSTALL プロパティが必要です。 このプロパティがないと、パッチはシステムに登録されますが、ファイルを更新することはできません。

Windows インストーラー 2.0:小さな更新プログラムまたはマイナー アップグレードのパッチを適用する場合は、コマンド ラインで REINSTALL プロパティを設定する必要があります。 REINSTALL プロパティと REINSTALLMODE プロパティを自動的に設定するためのカスタム アクションの種類 51 を使用しないパッチの場合、REINSTALL プロパティは CommandLine パラメーターを使用して明示的に設定する必要があります。 REINSTALL プロパティを設定して、パッチの影響を受ける機能を一覧表示するか、実際の既定の設定である "REINSTALL=ALL" を使用します。 REINSTALLMODE プロパティの既定値は "omus" です。

Windows インストーラー 3.0 以降: Windows インストーラー バージョン 3.0 以降では、REINSTALL プロパティはインストーラーによって構成され、コマンド ラインで設定する必要はありません。

必要条件

要件 値
バージョン
 Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー 3.0 以降。
[DLL]
Msi.dll
IID
 IID_IInstaller が 000C1090-0000-0000-C000-000000000046 として定義されている

こちらもご覧ください

MsiApplyPatch

プロパティについて

Windows Installer 2.0 以前でのサポート対象外