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 |
|---|---|
|
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 |
|---|---|
|
Les données de configuration sont endommagées. |
|
Un paramètre non valide a été transmis à la fonction. |
|
Une mémoire tampon est trop petite pour contenir les données demandées. |
|
La fonction s’est terminée avec succès. |
|
Le package correctif n’est pas installé. |
|
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 |