Partager via


MsiGetPatchFileListA, fonction (msi.h)

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 d’accès complet au 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 obligatoire.

[in, out] pphFileRecords

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

Valeur retournée

La fonction MsiGetPatchFileList retourne les valeurs suivantes.

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

Notes

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 fait l’objet d’une recherche dans l’ordre du contexte non managé 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 qui peuvent être mis à jour.

Notes

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. 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. Windows Installer 4.5 sur Windows Server 2003 et Windows XP. 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

Non pris en charge dans Windows Installer 3.1 (et versions antérieures)