Метод Installer.ProvideComponent

  • Статья

Метод ProvideComponent объекта Installer возвращает полный путь к компоненту и выполняет необходимую установку. При необходимости метод ProvideComponent объекта Installer запрашивает источник и увеличивает количество использования компонента.

Синтаксис

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

Параметры

Продукт

Указывает код продукта.

Компонент

Указывает идентификатор компонента, содержащего компонент.

Компонент

Указывает код компонента.

InstallMode

Определяет режим установки. Этот параметр может быть одним из значений, показанных в следующей таблице.

Имя Значение
msiInstallModeDefault
0
 Предоставляет путь к компоненту, при необходимости выполняя любую установку.
msiInstallModeExisting
–1
 Предоставляет путь к компоненту, только если функция существует; в противном случае возвращает пустую строку. Этот режим проверяет наличие файла ключа компонента.
msiInstallModeNoDetection
–2
 Предоставляет путь к компоненту, только если компонент существует. В противном случае возвращает пустую строку. В этом режиме проверяется регистрация компонента, но не проверяется наличие файла ключа компонента.
msiInstallModeNoSourceResolution
–3
 Предоставляет путь к компоненту, только если компонент существует с параметром InstallState msiInstallStateLocal. При этом проверяется регистрация компонента, но не проверяется наличие файла ключа компонента.
сочетание флагов msiReinstallMode
 Вызывает ReinstallFeature , чтобы переустановить компонент, используя этот параметр для параметра ReinstallMode , а затем предоставляет компонент .

 

Возвращаемое значение

Этот метод не возвращает значение.

Комментарии

Метод ProvideComponent сочетает в себе функциональные возможности UseFeature, ConfigureFeature и ComponentPath. Метод ProvideComponent упрощает последовательность вызовов, но он также увеличивает количество использования, и его следует использовать с осторожностью, чтобы предотвратить неточное количество использования. Метод ProvideComponent также обеспечивает меньшую гибкость, чем ряд отдельных вызовов методов и свойств, упомянутых ранее.

Если приложение восстанавливается после непредвиденной ситуации, вероятно, оно уже вызывало UseFeature и увеличило количество использования. В этом случае приложению следует избегать увеличения количества использования путем вызова метода ConfigureFeature вместо метода ProvideComponent .

Параметр msiInstallModeExisting нельзя использовать в сочетании с флагами msiReinstallMode.

Требования

Требование Значение
Версия
 Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или Установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP
DLL
Msi.dll
IID
 IID_IInstaller определяется как 000C1090-0000-0000-C000-0000000000046

См. также раздел

MsiProvideComponent