Metodo Installer.ApplyPatch

Articolo
06/12/2023

Per ogni prodotto elencato dal pacchetto patch come idoneo a ricevere la patch, il metodo ApplyPatch dell'oggetto Installer richiama un'installazione e imposta la proprietà PATCH sul percorso del pacchetto patch.

Sintassi

Installer.ApplyPatch(
  PatchPackage,
  InstallPackage,
  InstallType,
  CommandLine
)

Parametri

PatchPackage

Specifica un percorso del pacchetto patch.

InstallPackage

Se InstallType è impostato su msiInstallTypeNetworkImage, InstallPackage specifica il percorso del prodotto da applicare a patch. Se InstallType è impostato su msiInstallTypeDefault e InstallPackage è impostato su 0, il programma di installazione applica la patch a ogni prodotto idoneo elencato nel pacchetto di patch.

Se InstallType è msiInstallTypeSingleInstance, il programma di installazione applica la patch al prodotto specificato da InstallPackage. In questo caso, altri prodotti idonei elencati nel pacchetto patch vengono ignorati e il parametro InstallPackage contiene la stringa con terminazione null che rappresenta il codice prodotto dell'istanza da applicare alla patch. Questo tipo di installazione richiede la versione di Windows Installer fornita con Windows Server 2003 o versione successiva o Windows Installer XP SP1 o successiva.

InstallType

Questo parametro specifica il tipo di installazione da applicare a patch. Il parametro InstallType viene ignorato se InstallPackage viene omesso.

Valore	Significato
msiInstallTypeNetworkImage	Indica un'installazione amministrativa. In questo caso, InstallPackage deve essere impostato su un percorso del pacchetto. Un valore pari a 1 per msiInstallTypeNetworkImage specifica un'installazione amministrativa.
msiInstallTypeDefault	Cerca il sistema per applicare patch ai prodotti. In questo caso , InstallPackage deve essere una stringa vuota.
msiInstallSingleInstance	Applicare patch al prodotto specificato da InstallPackage. InstallPackage è il codice prodotto dell'istanza da applicare alle patch. Questo tipo di installazione richiede la versione di Windows Installer fornita con Windows Server 2003 o versione successiva o Windows Installer XP SP1 o successiva. Per altre informazioni, vedere Installazione di più istanze di prodotti e patch.

Commandline

Specifica le impostazioni delle proprietà impostate nella riga di comando. Vedere La sezione Osservazioni.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Poiché il delimitatore elenco per trasformazioni, origini e patch è un punto e virgola, questo carattere non deve essere usato per i nomi o i percorsi dei file.

La proprietà REINSTALL è necessaria quando si applica una piccola patch di aggiornamento o secondaria . Senza questa proprietà, la patch viene registrata nel sistema ma non può aggiornare i file.

Windows Installer 2.0: È necessario impostare la proprietà REINSTALL nella riga di comando quando si applica un piccolo aggiornamento o una patch di aggiornamento secondaria . Per le patch che non usano un tipo di azione personalizzato 51 per impostare automaticamente le proprietà REINSTALL E REINSTALLMODE, la proprietà REINSTALL deve essere impostata in modo esplicito con il parametro CommandLine. Impostare la proprietà REINSTALL per elencare le funzionalità interessate dalla patch oppure usare un'impostazione predefinita pratica di "REINSTALL=ALL". Il valore predefinito della proprietà REINSTALLMODE è "omus".

Windows Installer 3.0 e versioni successive: A partire da Windows Installer versione 3.0, la proprietà REINSTALL è configurata dal programma di installazione e non deve essere impostata sulla riga di comando.

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 3.0 o versione successiva in Windows Server 2003 o Windows XP.
DLL	Msi.dll
IID	IID_IInstaller è definito come 000C1090-0000-0000-C000-0000000000000046

Vedi anche

MsiApplyPatch
Informazioni sulle proprietà
Non supportato in Windows Installer 2.0 e versioni precedenti

Share via