MsiGetFeatureUsageA, fonction (msi.h)

Article
08/24/2023

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

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

Partager via