次の方法で共有

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
 HKEY_LOCAL_MACHINE に移動する レジストリ テーブル から必要なすべてのレジストリ エントリを書き換えます

または HKEY_CLASSES_ROOT

レジストリ ハイブ。 コンピューターまたはユーザーの割り当てに関係なく、クラス テーブル、動詞テーブル、PublishComponent Table、ProgID Table、MIMET Table、Icon Table、Extension Table、AppID Table からのすべての情報を書き換えます。 すべての 修飾されたコンポーネントを再インストールします。

アプリケーションを再インストールするときに、このオプションは 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 ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MsiReinstallProduct を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント 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 Service Pack の詳細については、Windows インストーラーの Run-Time 要件を参照してください。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msi.h
ライブラリ Msi.lib
DLL Msi.dll

関連項目

インストールおよび構成機能の

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

REINSTALLMODE プロパティ