MsiReinstallFeatureA 関数 (msi.h)

  • [アーティクル]

MsiReinstallFeature 関数は機能を再インストールします。

構文

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

パラメーター

[in] szProduct

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

[in] szFeature

再インストールする機能を指定します。 指定した機能の親機能または子機能は再インストールされません。 親または子機能を再インストールするには、それぞれについて MsiReinstallFeature 関数を個別に呼び出すか、 MsiReinstallProduct 関数を使用する必要があります。

[in] dwReinstallMode

インストールする内容を指定します。 このパラメーターには、次の 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

レジストリ ハイブに移動する必要なすべてのエントリを書き換えます。 マシンまたはユーザーの割り当てには関係なく、Class テーブル、Verb テーブル、PublishComponent テーブル、ProgID テーブル、MIME テーブル、Icon テーブル、Extension テーブル、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_FEATURE
 機能 ID では、既知の機能は識別されません。
ERROR_UNKNOWN_PRODUCT
 製品コードでは既知の製品が識別されません。
 

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

解説

注意

msi.h ヘッダーは、MSIReinstallFeature をエイリアスとして定義し、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 プロパティ