Condividi tramite


Installer.ProvideQualifiedComponent, metodo

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

Sintassi

Installer.ProvideQualifiedComponent(
  Category,
  Qualifier,
  InstallMode
)

Parametri

Categoria

Specifica l'ID componente per il componente richiesto. Questo potrebbe non essere il GUID per il componente stesso, ma piuttosto un server che fornisce la funzionalità corretta, come nella colonna ComponentId della tabella PublishComponent.

Qualifier

Specifica un qualificatore in un elenco di componenti pubblicitari (dalla tabella PublishComponent).

InstallMode

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

InstallMode Significato
msiInstallModeDefault
0
Fornisce il componente, eseguendo qualsiasi installazione necessaria.
msiInstallModeExisting
–1
Fornisce il 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 componente solo se la funzionalità esiste; in caso contrario, restituisce una stringa vuota. Questa modalità controlla solo che il componente sia registrato ma non verifichi 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.

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

MsiProvideQualifiedComponent