Partager via


MsiApplyMultiplePatchesA, 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 MsiApplyMultiplePatchesA(
  [in]           LPCSTR szPatchPackages,
  [in, optional] LPCSTR szProductCode,
  [in, optional] LPCSTR szPropertiesList
);

Paramètres

[in] szPatchPackages

Liste délimitée par des points-virgules des chemins d’accès aux fichiers de correction sous la 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 appelant 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.

Note La liste des propriétés ne doit pas contenir la propriété PATCH . Si la propriété PATCH est définie dans la ligne de commande, la valeur est ignorée et remplacée par les correctifs appliqués.
 

Valeur retournée

La fonction MsiApplyMultiplePatches retourne les valeurs suivantes.

Valeur Signification
ERROR_INVALID_PARAMETER
Certains arguments passés sont incorrects ou en contradiction.
ERROR_SUCCESS
La fonction s’est terminée et tous les produits sont correctement corrigés. ERROR_SUCCESS est retourné uniquement si tous les produits éligibles aux correctifs ont été corrigés avec succès. Si aucun des nouveaux correctifs n’est applicable, MsiApplyMultiplePatches retourne ERROR_SUCCESS et l’état du produit reste inchangé.
ERROR_SUCCESS_REBOOT_INITIATED
Le redémarrage initié par la dernière transaction a arrêté cet appel à MsiApplyMultiplePatches. Tous les produits cibles n’ont peut-être pas été corrigés.
ERROR_SUCCESS_REBOOT_REQUIRED
Le redémarrage requis par la dernière transaction a arrêté cet appel à MsiApplyMultiplePatches. Tous les produits cibles n’ont peut-être pas été corrigés.
ERROR_PATCH_PACKAGE_OPEN_FAILED
Impossible d’ouvrir l’un des packages de correctifs fournis.
ERROR_PATCH_PACKAGE_INVALID
L’un des packages de correctifs fournis n’est pas valide.
ERROR_PATCH_PACKAGE_UNSUPPORTED
L’un des packages de correctifs n’est pas pris en charge.
Toute erreur dans Winerror.h
Implique l’achèvement partiel possible ou qu’une ou plusieurs transactions ont échoué.

Notes

Notes

L’en-tête msi.h définit MsiApplyMultiplePatches en tant qu’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. La combinaison 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

About Properties

Installations à plusieurs packages

Non pris en charge par Windows Installer 2.0 et antérieur

PATCH

ProductCode

Définition des valeurs de propriété publique sur la ligne de commande