MsiGetFeatureUsageA, fonction (msi.h)

  • Article

La fonction MsiGetFeatureUsage retourne les métriques d’utilisation d’une fonctionnalité de produit.

Syntaxe

UINT MsiGetFeatureUsageA(
  [in]  LPCSTR  szProduct,
  [in]  LPCSTR  szFeature,
  [out] LPDWORD pdwUseCount,
  [out] LPWORD  pwDateUsed
);

Paramètres

[in] szProduct

Spécifie le code de produit du produit qui contient la fonctionnalité.

[in] szFeature

Spécifie le code de fonctionnalité pour la fonctionnalité pour laquelle les métriques doivent être retournées.

[out] pdwUseCount

Indique le nombre de fois où la fonctionnalité a été utilisée.

[out] pwDateUsed

Spécifie la date de la dernière utilisation de la fonctionnalité. La date est au format de date MS-DOS, comme indiqué dans le tableau suivant.

Bits Signification
0 – 4
 Jour du mois (1 à 31)
5 – 8
 Mois (1 = janvier, 2 = février, et ainsi de suite)
9 – 15
 Décalage de l’année à partir de 1980 (ajouter 1980 pour obtenir l’année réelle)

Valeur retournée

La fonction MsiGetFeatureUsage retourne les valeurs suivantes.

Valeur Signification
ERROR_BAD_CONFIGURATION
 Les données de configuration sont endommagées.
ERROR_INSTALL_FAILURE
 Aucune information d’utilisation n’est disponible ou le produit ou la fonctionnalité n’est pas valide.
ERROR_SUCCESS
 La fonction s’est terminée avec succès.

Notes

Notes

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

Fonctions d’état du système