Metodo Installer.ProvideComponent

Il metodo ProvideComponent dell'oggetto Installer restituisce il percorso completo del componente ed esegue qualsiasi installazione necessaria. Se necessario, il metodo ProvideComponent dell'oggetto Installer richiede l'origine e incrementa il conteggio di utilizzo per la funzionalità.

Sintassi

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

Parametri

Prodotto

Specifica il codice prodotto del prodotto.

Funzionalità

Specifica l'ID funzionalità della funzionalità contenente il componente.

Componente

Specifica il codice del componente.

InstallMode

Definisce la modalità di installazione. Questo parametro può essere uno dei valori illustrati nella tabella seguente.

Nome Significato
msiInstallModeDefault
0
Fornisce il percorso del componente, eseguendo qualsiasi installazione, se necessario.
msiInstallModeExisting
–1
Fornisce il percorso del componente solo se la funzionalità esiste; in caso contrario, restituisce una stringa vuota. Questa modalità verifica l'esistenza del file di chiave del componente.
msiInstallModeNoDetection
–2
Fornisce il percorso del componente solo se la funzionalità esiste. In caso contrario, restituisce una stringa vuota. Questa modalità controlla la registrazione del componente, ma non verifica l'esistenza del file di chiave del componente.
msiInstallModeNoSourceResolution
–3
Fornisce il percorso del componente solo se la funzionalità esiste con un parametro InstallState di msiInstallStateLocal. In questo modo viene controllata la registrazione del componente, ma non viene verificata l'esistenza del file di chiave del componente.
combinazione dei flag msiReinstallMode
Chiama ReinstallFeature per reinstallare la funzionalità usando questo parametro per il parametro ReinstallMode e quindi fornisce il componente.

 

Valore restituito

Questo metodo non restituisce valori.

Commenti

Il metodo ProvideComponent combina le funzionalità di UseFeature, ConfigureFeature e ComponentPath. Il metodo ProvideComponent semplifica la sequenza chiamante, ma incrementa anche il numero di utilizzo e deve essere usato con cautela per evitare conteggi di utilizzo non accurati. Il metodo ProvideComponent offre anche una minore flessibilità rispetto a una serie di singole chiamate ai metodi e alle proprietà menzionate in precedenza.

Se l'applicazione viene ripristinata da una situazione imprevista, l'applicazione ha probabilmente già chiamato UseFeature e ha incrementato il numero di utilizzo. In questo caso, l'applicazione deve evitare di incrementare il numero di utilizzo chiamando il metodo ConfigureFeature anziché il metodo ProvideComponent .

L'opzione msiInstallModeExisting non può essere usata in combinazione con i flag msiReinstallMode.

Requisiti

Requisito Valore
Versione
Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP
DLL
Msi.dll
IID
IID_IInstaller è definito come 000C1090-0000-0000-C000-000000000046

Vedi anche

MsiProvideComponent