Funzione MsiApplyMultiplePatchesA (msi.h)

Articolo
08/24/2023

La funzione MsiApplyMultiplePatches applica una o più patch ai prodotti idonei per ricevere le patch. La funzione MsiApplyMultiplePatches imposta la proprietà PATCH con un elenco di patch delimitate da punti e virgola e richiama l'applicazione di patch dei prodotti di destinazione. Altre proprietà possono essere impostate usando un elenco di proprietà.

Sintassi

UINT MsiApplyMultiplePatchesA(
  [in]           LPCSTR szPatchPackages,
  [in, optional] LPCSTR szProductCode,
  [in, optional] LPCSTR szPropertiesList
);

Parametri

[in] szPatchPackages

Elenco delimitato da punti e virgola dei percorsi per applicare patch ai file come singola stringa. Ad esempio: ""c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp" "

[in, optional] szProductCode

Questo parametro è il GUID ProductCode del prodotto da applicare a patch. L'utente o l'applicazione che chiama MsiApplyMultiplePatches deve avere privilegi per applicare le patch. Quando questo parametro è NULL, le patch vengono applicate a tutti i prodotti idonei. Quando questo parametro non è NULL, le patch vengono applicate solo al prodotto specificato.

[in, optional] szPropertiesList

Stringa con terminazione null che specifica le impostazioni delle proprietà della riga di comando usate durante l'applicazione di patch dei prodotti. Se non sono presenti impostazioni delle proprietà della riga di comando, passare un puntatore NULL . Una stringa vuota è un parametro non valido. Queste proprietà sono condivise da tutti i prodotti di destinazione. Per ulteriori informazioni, vedere
Informazioni sulle proprietà e sull'impostazione dei valori delle proprietà pubbliche nella riga di comando.

Nota L'elenco delle proprietà non deve contenere la proprietà PATCH . Se la proprietà PATCH è impostata nella riga di comando, il valore viene ignorato e viene sovrascritto con le patch applicate.

Valore restituito

La funzione MsiApplyMultiplePatches restituisce i valori seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Alcuni argomenti passati non sono corretti o contraddittori.
ERROR_SUCCESS	La funzione è stata completata e tutti i prodotti sono stati patchati correttamente. ERROR_SUCCESS viene restituito solo se tutti i prodotti idonei per le patch vengono corretti correttamente. Se nessuno dei nuovi patch è applicabile, MsiApplyMultiplePatches restituisce ERROR_SUCCESS e lo stato del prodotto rimane invariato.
ERROR_SUCCESS_REBOOT_INITIATED	Il riavvio avviato dall'ultima transazione ha terminato questa chiamata a MsiApplyMultiplePatches. Tutti i prodotti di destinazione potrebbero non essere stati patchati.
ERROR_SUCCESS_REBOOT_REQUIRED	Il riavvio richiesto dall'ultima transazione ha terminato questa chiamata a MsiApplyMultiplePatches. Tutti i prodotti di destinazione potrebbero non essere stati patchati.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Non è stato possibile aprire uno dei pacchetti di patch.
ERROR_PATCH_PACKAGE_INVALID	Uno dei pacchetti di patch forniti non è uno valido.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Uno dei pacchetti di patch non è supportato.
Qualsiasi errore in Winerror.h	Implica il completamento parziale possibile o una o più transazioni non riuscite.

Commenti

Nota

L'intestazione msi.h definisce MsiApplyMultiplePatches come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	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. Per informazioni sul Service Pack minimo di Windows Richiesto da una versione di Windows Installer, vedere i requisiti di Windows Installer Run-Time.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll