MsiApplyMultiplePatchesA, fonction (msi.h)

Article
08/24/2023

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

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