MsiReinstallProductA 関数 (msi.h)

MsiReinstallProduct 関数は、製品を再インストールします。

構文

UINT MsiReinstallProductA(
  [in] LPCSTR szProduct,
  [in] DWORD  szReinstallMode
);

パラメーター

[in] szProduct

再インストールする製品の製品コードを指定します。

[in] szReinstallMode

再インストール モードを指定します。 このパラメーターには、次の 1 つ以上の値を指定できます。

説明
REINSTALLMODE_FILEMISSING
ファイルがない場合にのみ再インストールします。
REINSTALLMODE_FILEOLDERVERSION
ファイルがないか、または以前のバージョンである場合に再インストールします。
REINSTALLMODE_FILEEQUALVERSION
ファイルがないか、または同じバージョンか以前のバージョンである場合に再インストールします。
REINSTALLMODE_FILEEXACT
ファイルが見つからない場合、または別のバージョンの場合は、再インストールします。
REINSTALLMODE_FILEVERIFY
チェックサム値を確認し、ファイルが見つからないか破損している場合は、ファイルを再インストールします。 このフラグは、 ファイル テーブルの Attributes 列に msidbFileAttributesChecksum があるファイルのみを修復します。
REINSTALLMODE_FILEREPLACE
チェックサムまたはバージョンには関係なく、すべてのファイルが強制的に再インストールされます。
REINSTALLMODE_USERDATA
HKEY_CURRENT_USERに移動するレジストリ テーブルから必要なすべてのレジストリ エントリを書き換えます

または HKEY_USERS

レジストリ ハイブに移動する必要なすべてのエントリを書き換えます。
REINSTALLMODE_MACHINEDATA
Registry テーブルのレジストリ エントリのうち、HKEY_LOCAL_MACHINE

または HKEY_CLASSES_ROOT

レジストリ ハイブに移動する必要なすべてのエントリを書き換えます。 マシンまたはユーザーの割り当てに関係なく、 クラス テーブル動詞テーブルPublishComponent テーブルProgID テーブルMIMET テーブルアイコン テーブル拡張テーブルAppID テーブル のすべての情報を書き換えます。 すべての修飾コンポーネントを再インストールします。

アプリケーションを再インストールするときに、このオプションは RegisterTypeLibraries アクションと InstallODBC アクションを実行します。

REINSTALLMODE_SHORTCUT
すべてのショートカットを再インストールし、すべてのアイコンを再キャッシュして、既存のショートカットとアイコンをすべて上書きします。
REINSTALLMODE_PACKAGE
ソース パッケージから実行し、ローカル パッケージを再キャッシュする場合に使用します。 アプリケーションまたは機能の最初のインストールには を使用しないでください。

戻り値

リターン コード 説明
ERROR_INSTALL_FAILURE
インストールに失敗しました。
ERROR_INVALID_PARAMETER
無効なパラメーターが関数に渡されました。
ERROR_INSTALL_SERVICE_FAILURE
インストール サービスにアクセスできませんでした。
ERROR_INSTALL_SUSPEND
インストールが中断され、不完全です。
ERROR_INSTALL_USEREXIT
ユーザーがインストールを取り消しました。
ERROR_SUCCESS
関数は正常に終了しました。
ERROR_UNKNOWN_PRODUCT
製品コードでは既知の製品が識別されません。
 

詳細については、「 表示されたエラー メッセージ」を参照してください。

解説

注意

msi.h ヘッダーは、MSIReinstallProduct をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント 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 インストーラー。 Windows インストーラーのバージョン別に必須となる最小 Windows サービス パックに関する詳細については、Windows インストーラーの実行時の要件に関する記事を参照してください。
対象プラットフォーム Windows
ヘッダー msi.h
Library Msi.lib
[DLL] Msi.dll

関連項目

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

複数のパッケージのインストール

REINSTALLMODE プロパティ