Partager via


MsiGetPatchInfoA, fonction (msi.h)

La fonction MsiGetPatchInfo retourne des informations sur un correctif.

Syntaxe

UINT MsiGetPatchInfoA(
  [in]      LPCSTR  szPatch,
  [in]      LPCSTR  szAttribute,
  [out]     LPSTR   lpValueBuf,
  [in, out] LPDWORD pcchValueBuf
);

Paramètres

[in] szPatch

Spécifie le code de correctif pour le package de correctifs.

[in] szAttribute

Spécifie l’attribut à récupérer.

Attribut Signification
INSTALLPROPERTY_LOCALPACKAGE
Package mis en cache local.

[out] lpValueBuf

Pointeur vers une mémoire tampon qui reçoit la valeur de la propriété. Ce paramètre peut avoir la valeur Null.

[in, out] pcchValueBuf

Pointeur vers une variable qui spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpValueBuf . En entrée, il s’agit de la taille complète de la mémoire tampon, y compris un espace pour un caractère null de fin. Si la mémoire tampon passée est trop petite, le nombre retourné n’inclut pas le caractère null de fin.

Si lpValueBuf a la valeur null, pcchValueBuf peut être null.

Valeur retournée

La fonction MsiGetPatchInfo retourne les valeurs suivantes.

Valeur Signification
ERROR_BAD_CONFIGURATION
Les données de configuration sont endommagées.
ERROR_INVALID_PARAMETER
Un paramètre non valide a été transmis à la fonction.
ERROR_MORE_DATA
Une mémoire tampon est trop petite pour contenir les données demandées.
ERROR_SUCCESS
La fonction s’est terminée avec succès.
ERROR_UNKNOWN_PRODUCT
Le package correctif n’est pas installé.
ERROR_UNKNOWN_PROPERTY
La propriété n’est pas reconnue.
 
 

Notes

Lorsque la fonction MsiGetPatchInfo retourne, le paramètre pcchValueBuf contient la longueur de la chaîne de classe stockée dans la mémoire tampon. Le nombre retourné n’inclut pas le caractère null de fin.

Si la mémoire tampon est trop petite pour contenir les données demandées, MsiGetPatchInfo retourne ERROR_MORE_DATA et pcchValueBuf contient le nombre de caractères copiés dans lpValueBuf, sans compter le caractère null.

Notes

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

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 sur Windows Server 2003 ou 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 par Windows Installer 2.0 et antérieur