MsiApplyMultiplePatchesA, fonction (msi.h)

Article
11/20/2024

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 patch sous forme de 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 ProductCode GUID du produit à corriger. L’utilisateur ou l’application appelant MsiApplyMultiplePatches doivent disposer de privilèges pour appliquer des correctifs. Lorsque ce paramètre est NULL, les correctifs sont appliqués à tous les produits éligibles. Lorsque ce paramètre n’est pasnull, 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 pendant la mise à jour corrective des produits. S’il n’existe aucun paramètre de propriété de ligne de commande, passez 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
À propos des propriétés et définition des valeurs de propriété publique sur la ligne de commande.

Remarque 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 de retour

La fonction MsiApplyMultiplePatches retourne les valeurs suivantes.

Valeur	Signification
ERROR_INVALID_PARAMETER	Certains arguments passés sont incorrects ou contredisants.
ERROR_SUCCESS	La fonction est terminée et tous les produits sont correctement corrigés. ERROR_SUCCESS est retourné uniquement si tous les produits éligibles pour les correctifs sont 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 lancé par la dernière transaction a terminé 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 terminé cet appel à MsiApplyMultiplePatches. Tous les produits cibles n’ont peut-être pas été corrigés.
ERROR_PATCH_PACKAGE_OPEN_FAILED	L’un des packages de correctifs fournis n’a pas pu être ouvert.
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 l’échec d’une ou de plusieurs transactions.

Remarques

Note

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

Exigences

Exigence	Valeur
client minimum 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. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer.
plateforme cible	Windows
d’en-tête	msi.h
bibliothèque	Msi.lib
DLL	Msi.dll