MsiGetFeatureUsageA, fonction (msi.h)

Article
11/20/2024

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

Partager via