Método Installer.ProvideComponent

El método ProvideComponent del objeto Installer devuelve la ruta de acceso completa del componente y realiza cualquier instalación necesaria. Si es necesario, el método ProvideComponent del objeto Installer solicita el origen e incrementa el recuento de uso de la característica.

Sintaxis

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

Parámetros

Producto

Especifica el código del producto.

Característica

Especifica el identificador de característica de la característica que contiene el componente.

Componente

Especifica el código del componente.

InstallMode

Define el modo de instalación. Este parámetro puede ser uno de los valores que se muestran en la tabla siguiente.

Nombre	Significado
msiInstallModeDefault 0	Proporciona la ruta de acceso del componente, realizando cualquier instalación, si es necesario.
msiInstallModeExisting –1	Proporciona la ruta de acceso del componente solo si existe la característica; de lo contrario, devuelve una cadena vacía. Este modo comprueba la existencia del archivo de clave del componente.
msiInstallModeNoDetection -2	Proporciona la ruta de acceso del componente solo si existe la característica. En cualquier otro caso, devuelve una cadena vacía. Este modo comprueba el registro del componente, pero no comprueba la existencia del archivo de clave del componente.
msiInstallModeNoSourceResolution –3	Proporciona la ruta de acceso del componente solo si la característica existe con un parámetro InstallState de msiInstallStateLocal. Esto comprueba el registro del componente, pero no comprueba la existencia del archivo de clave del componente.
Combinación de las marcas msiReinstallMode	Llama a ReinstallFeature para reinstalar la característica mediante este parámetro para el parámetro ReinstallMode y, a continuación, proporciona el componente.

 

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

El método ProvideComponent combina la funcionalidad de UseFeature, ConfigureFeature y ComponentPath. El método ProvideComponent simplifica la secuencia de llamada, pero también incrementa el recuento de uso y se debe usar con precaución para evitar recuentos de uso inexactos. El método ProvideComponent también proporciona menos flexibilidad que una serie de llamadas individuales a los métodos y propiedades mencionados anteriormente.

Si la aplicación se está recuperando de una situación inesperada, es probable que la aplicación ya haya llamado a UseFeature e incremente el recuento de uso. En este caso, la aplicación debe evitar incrementar el recuento de uso llamando al método ConfigureFeature en lugar de al método ProvideComponent.

La opción msiInstallModeExisting no se puede usar en combinación con marcas msiReinstallMode.

Requisitos

Consulte también

MsiProvideComponent