次の方法で共有


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 以前でのサポート対象外