次の方法で共有

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

または HKEY_CLASSES_ROOT

レジストリ ハイブ。 コンピューターまたはユーザーの割り当てに関係なく、クラス テーブル、動詞テーブル、PublishComponent Table、ProgID Table、MIME 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_FEATURE
 機能 ID は既知の機能を識別しません。
ERROR_UNKNOWN_PRODUCT
 製品コードは既知の製品を識別しません。
 

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

備考

手記

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

必要条件

要件 価値
サポートされる最小クライアント 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

関連項目

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

Multiple-Package インストール

REINSTALLMODE プロパティ