Installer.ProvideComponent メソッド

Installer オブジェクトの ProvideComponent メソッドは、完全なコンポーネント パスを返し、必要なインストールを実行します。 Installer オブジェクトの ProvideComponent メソッドは、必要に応じてソースの入力を求め、機能の使用カウントを増やします。

構文

Installer.ProvideComponent(
  Product,
  Feature,
  Component,
  InstallMode
)

パラメーター

製品

製品の製品コードを指定します。

機能

コンポーネントを含む機能の機能 ID を指定します。

コンポーネント

コンポーネント コードを指定します。

InstallMode

インストール モードを定義します。 このパラメーターには次の表に示すいずれかの値を指定できます。

名前	意味
msiInstallModeDefault 0	コンポーネント パスを提供し、必要であればインストールを実行します。
msiInstallModeExisting –1	機能が存在する場合にのみコンポーネント パスを提供し、それ以外の場合は空の文字列を返します。 このモードでは、コンポーネントのキー ファイルの存在が検証されます。
msiInstallModeNoDetection –2	機能が存在する場合にのみ、コンポーネント パスを提供します。 それ以外の場合は、空の文字列を返します。 このモードでは、コンポーネントの登録はチェックされますが、コンポーネントのキー ファイルの存在は検証されません。
msiInstallModeNoSourceResolution –3	InstallState パラメーターが msiInstallStateLocal の機能が存在する場合にのみ、コンポーネント パスを提供します。 コンポーネントの登録はチェックされますが、コンポーネントのキー ファイルの存在は検証されません。
msiReinstallMode フラグの組み合わせ	ReinstallMode パラメーターにこのパラメーターを使用して ReinstallFeature を呼び出し、機能を再インストールし、コンポーネントを提供します。

 

戻り値

このメソッドは値を返しません。

解説

ProvideComponent メソッドは、UseFeature、ConfigureFeature、ComponentPath の機能を組み合わせたものです。 ProvideComponent メソッドを使うと呼び出しシーケンスが簡単になりますが、使用カウントも増えるので、使用カウントが不正確にならないように注意して使う必要があります。 また、ProvideComponent メソッドは、前に示した一連のメソッドとプロパティを個別に呼び出すより、柔軟性が低くなります。

アプリケーションが予期しない状況から復旧している場合、アプリケーションは既に UseFeature を呼び出し、使用カウントを増やしている可能性があります。 この場合、アプリケーションでは、ProvideComponent メソッドではなく ConfigureFeature メソッドを呼び出して、使用カウントを増やさないようにする必要があります。

msiInstallModeExisting オプションを msiReinstallMode フラグと組み合わせて使うことはできません。

必要条件

要件	値
バージョン	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 インストーラー
[DLL]	Msi.dll
IID	IID_IInstaller が 000C1090-0000-0000-C000-000000000046 として定義されている

こちらもご覧ください

MsiProvideComponent