MsiApplyMultiplePatchesW, fonction (msi.h)
La fonction MsiApplyMultiplePatches applique un ou plusieurs correctifs aux produits éligibles pour recevoir les correctifs. La fonction MsiApplyMultiplePatches définit la propriété PATCH avec une liste de correctifs délimités par des points-virgules et appelle la mise à jour corrective des produits cibles. D’autres propriétés peuvent être définies à l’aide d’une liste de propriétés.
Syntaxe
UINT MsiApplyMultiplePatchesW(
[in] LPCWSTR szPatchPackages,
[in, optional] LPCWSTR szProductCode,
[in, optional] LPCWSTR szPropertiesList
);
Paramètres
[in] szPatchPackages
Liste délimitée par des points-virgules des chemins d’accès aux fichiers correctifs sous forme d’une chaîne unique. Par exemple : « "c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp » »
[in, optional] szProductCode
Ce paramètre est le GUID ProductCode du produit à corriger. L’utilisateur ou l’application qui appelle MsiApplyMultiplePatches doit disposer de privilèges pour appliquer des correctifs. Lorsque ce paramètre a la valeur NULL, les correctifs sont appliqués à tous les produits éligibles. Lorsque ce paramètre n’a pas la valeur NULL, les correctifs sont appliqués uniquement au produit spécifié.
[in, optional] szPropertiesList
Chaîne terminée par null qui spécifie les paramètres de propriété de ligne de commande utilisés lors de la mise à jour corrective des produits. S’il n’existe aucun paramètre de propriété de ligne de commande, transmettez un pointeur NULL . Une chaîne vide est un paramètre non valide. Ces propriétés sont partagées par tous les produits cibles. Pour plus d'informations, consultez la rubrique
À propos des propriétés et de la définition des valeurs de propriété publique sur la ligne de commande.
Valeur retournée
La fonction MsiApplyMultiplePatches retourne les valeurs suivantes.
Valeur | Signification |
---|---|
|
Certains arguments transmis sont incorrects ou contredisants. |
|
La fonction s’est terminée et tous les produits sont correctement corrigés. ERROR_SUCCESS est retourné uniquement si tous les produits éligibles pour les correctifs ont été correctement corrigés. Si aucun des nouveaux correctifs n’est applicable, MsiApplyMultiplePatches retourne ERROR_SUCCESS et l’état du produit reste inchangé. |
|
Le redémarrage initié par la dernière transaction a mis fin à cet appel à MsiApplyMultiplePatches. Tous les produits cibles n’ont peut-être pas été corrigés. |
|
Le redémarrage requis par la dernière transaction a mis fin à cet appel à MsiApplyMultiplePatches. Tous les produits cibles n’ont peut-être pas été corrigés. |
|
L’un des packages correctifs fournis n’a pas pu être ouvert. |
|
L’un des packages correctifs fournis n’est pas valide. |
|
L’un des packages correctifs n’est pas pris en charge. |
|
Implique une exécution partielle possible ou l’échec d’une ou plusieurs transactions. |
Notes
Notes
L’en-tête msi.h définit MsiApplyMultiplePatches comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Spécifications
Client minimal pris en charge | Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows. |
Plateforme cible | Windows |
En-tête | msi.h |
Bibliothèque | Msi.lib |
DLL | Msi.dll |
Voir aussi
Installations à plusieurs packages
Non pris en charge par Windows Installer 2.0 et antérieur
Définition des valeurs de propriété publique sur la ligne de commande