Funzione MsiApplyMultiplePatchesA (msi.h)

Articolo
11/20/2024

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. È possibile impostare altre proprietà 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 punto 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 ProductCode GUID del prodotto da applicare con patch. L'utente o l'applicazione che chiama MsiApplyMultiplePatches devono disporre dei privilegi per applicare 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 altre informazioni, vedere
Informazioni sulle proprietà e 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 viene 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 in contraddizione.
ERROR_SUCCESS	La funzione è stata completata e tutti i prodotti sono stati corretti. ERROR_SUCCESS viene restituito solo se tutti i prodotti idonei per le patch vengono patch correttamente. Se nessuna delle nuove 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 patch forniti.
ERROR_PATCH_PACKAGE_INVALID	Uno dei pacchetti patch forniti non è valido.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Uno dei pacchetti patch non è supportato.
Qualsiasi errore in Winerror.h	Implica un possibile completamento parziale o che una o più transazioni non sono riuscite.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
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 Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll