Funzione MsiApplyMultiplePatchesW (msi.h)

Articolo
03/15/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. È possibile impostare altre proprietà usando un elenco di proprietà.

Sintassi

UINT MsiApplyMultiplePatchesW(
  [in]           LPCWSTR szPatchPackages,
  [in, optional] LPCWSTR szProductCode,
  [in, optional] LPCWSTR 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 GUID ProductCode del prodotto da applicare alle patch. L'utente o l'applicazione che chiama MsiApplyMultiplePatches deve disporre dei privilegi per applicare le patch. Quando questo parametro è NULL, le patch vengono applicate a tutti i prodotti idonei. Quando questo parametro è diverso da 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 utilizzate 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 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 di patch forniti.
ERROR_PATCH_PACKAGE_INVALID	Uno dei pacchetti di patch forniti non è valido.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Uno dei pacchetti di patch non è supportato.
Qualsiasi errore in Winerror.h	Implica un possibile completamento parziale o che una o più transazioni non sono 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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 Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll