MsiGetFeatureUsageA, fonction (msi.h)

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é de 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 à laquelle la fonctionnalité a été utilisée pour la dernière fois. La date est au format de date MS-DOS, comme indiqué dans le tableau suivant.

Bribes 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 1980 (ajouter 1980 pour obtenir l’année réelle)

Valeur de retour

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 correctement.

Remarques

Note

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

fonctions d’état système