MsiGetPatchFileListA, fonction (msi.h)

Article
11/20/2024

La fonction MsiGetPatchFileList est fournie une liste de fichiers .msp, délimités par des points-virgules, et récupère la liste des fichiers qui peuvent être mis à jour par les correctifs.

Syntaxe

UINT MsiGetPatchFileListA(
  [in]      LPCSTR    szProductCode,
  [in]      LPCSTR    szPatchPackages,
  [in, out] LPDWORD   pcFiles,
  [in, out] MSIHANDLE **pphFileRecords
);

Paramètres

[in] szProductCode

Valeur de chaîne terminée par null contenant le ProductCode (GUID) du produit qui est la cible des correctifs. Ce paramètre ne peut pas être NULL.

[in] szPatchPackages

Valeur de chaîne terminée par null qui contient la liste des correctifs Windows Installer (fichiers.msp). Chaque correctif peut être spécifié par le chemin complet du package de correctifs. Les correctifs de la liste sont délimités par des points-virgules. Au moins un correctif doit être spécifié.

[in, out] pcFiles

Pointeur vers un emplacement qui reçoit le nombre de fichiers qui seront mis à jour sur ce système par cette liste de correctifs spécifiés par szPatchList. Ce paramètre est requis.

[in, out] pphFileRecords

Pointeur vers un emplacement qui reçoit un pointeur vers un tableau d’enregistrements. Le premier champ (0-index) de chaque enregistrement contient le chemin d’accès complet d’un fichier pouvant être mis à jour lorsque la liste des correctifs dans szPatchList sont appliquées sur cet ordinateur. Ce paramètre est requis.

Valeur de retour

La fonction MsiGetPatchFileList retourne les valeurs suivantes.

Valeur	Signification
ERROR_SUCCESS	La fonction s’est terminée correctement.
ERROR_INVALID_PARAMETER	Un paramètre non valide a été passé à la fonction.
ERROR_FUNCTION_FAILED	Échec de la fonction.

Remarques

Par exemple, szPatchList peut avoir la valeur « c :\sus\download\cache\Office\sp1.msp ; c :\sus\download\cache\Office\QFE1.msp ; c :\sus\download\cache\Office\QFEn.msp".

Cette fonction s’exécute dans le contexte de l’appelant. Le code de produit est recherché dans l’ordre du contexte non géré par l’utilisateur, du contexte géré par l’utilisateur et du contexte de l’ordinateur.

Vous devez fermer tous les objets MSIHANDLE retournés par cette fonction en appelant la fonction MsiCloseHandle.

Si la fonction échoue, vous pouvez obtenir des informations d’erreur étendues à l’aide de la fonction MsiGetLastErrorRecord.

Pour plus d’informations sur l’utilisation de la fonction MsiGetPatchFileList, consultez Liste des fichiers pouvant être mis à jour.

Note

L’en-tête msi.h définit MsiGetPatchFileList 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. Windows Installer 4.5 sur Windows Server 2003 et Windows XP. 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

Voir aussi

non pris en charge dans Windows Installer 3.1 et versions antérieures

Partager via