MsiReinstallProductA 関数 (msi.h)
MsiReinstallProduct 関数は、製品を再インストールします。
構文
UINT MsiReinstallProductA(
[in] LPCSTR szProduct,
[in] DWORD szReinstallMode
);
パラメーター
[in] szProduct
再インストールする製品の製品コードを指定します。
[in] szReinstallMode
再インストール モードを指定します。 このパラメーターには、次の 1 つ以上の値を指定できます。
| 値 | 説明 |
|---|---|
|
ファイルがない場合にのみ再インストールします。 |
|
ファイルがないか、または以前のバージョンである場合に再インストールします。 |
|
ファイルがないか、または同じバージョンか以前のバージョンである場合に再インストールします。 |
|
ファイルが見つからない場合、または別のバージョンの場合は、再インストールします。 |
|
チェックサム値を確認し、ファイルが見つからないか破損している場合は、ファイルを再インストールします。 このフラグは、 ファイル テーブルの Attributes 列に msidbFileAttributesChecksum があるファイルのみを修復します。 |
|
チェックサムまたはバージョンには関係なく、すべてのファイルが強制的に再インストールされます。 |
|
HKEY_CURRENT_USERに移動するレジストリ テーブルから必要なすべてのレジストリ エントリを書き換えます または HKEY_USERS レジストリ ハイブに移動する必要なすべてのエントリを書き換えます。 |
|
Registry テーブルのレジストリ エントリのうち、HKEY_LOCAL_MACHINE または HKEY_CLASSES_ROOT レジストリ ハイブに移動する必要なすべてのエントリを書き換えます。 マシンまたはユーザーの割り当てに関係なく、 クラス テーブル、 動詞テーブル、 PublishComponent テーブル、 ProgID テーブル、 MIMET テーブル、 アイコン テーブル、 拡張テーブル、 AppID テーブル のすべての情報を書き換えます。 すべての修飾コンポーネントを再インストールします。
アプリケーションを再インストールするときに、このオプションは RegisterTypeLibraries アクションと InstallODBC アクションを実行します。 |
|
すべてのショートカットを再インストールし、すべてのアイコンを再キャッシュして、既存のショートカットとアイコンをすべて上書きします。 |
|
ソース パッケージから実行し、ローカル パッケージを再キャッシュする場合に使用します。 アプリケーションまたは機能の最初のインストールには を使用しないでください。 |
戻り値
| リターン コード | 説明 |
|---|---|
|
インストールに失敗しました。 |
|
無効なパラメーターが関数に渡されました。 |
|
インストール サービスにアクセスできませんでした。 |
|
インストールが中断され、不完全です。 |
|
ユーザーがインストールを取り消しました。 |
|
関数は正常に終了しました。 |
|
製品コードでは既知の製品が識別されません。 |
詳細については、「 表示されたエラー メッセージ」を参照してください。
解説
注意
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 |