Метод 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.

Требования

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

MsiProvideComponent