MsiUseFeatureExA, fonction (msi.h)

Article
11/20/2024

La fonction MsiUseFeatureEx incrémente le nombre d’utilisations d’une fonctionnalité particulière et indique l’état d’installation de cette fonctionnalité. Cette fonction doit être utilisée pour indiquer l’intention d’une application d’utiliser une fonctionnalité.

Syntaxe

INSTALLSTATE MsiUseFeatureExA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwInstallMode,
  [in] DWORD  dwReserved
);

Paramètres

[in] szProduct

Spécifie le code de produit du produit qui possède la fonctionnalité à utiliser.

[in] szFeature

Identifie la fonctionnalité à utiliser.

[in] dwInstallMode

Ce paramètre peut avoir la valeur suivante.

Valeur	Signification
INSTALLMODE_NODETECTION	La valeur de retour indique l’état d’installation.

[in] dwReserved

Réservé pour une utilisation ultérieure. Cette valeur doit être définie sur 0.

Valeur de retour

Valeur	Signification
INSTALLSTATE_ABSENT	La fonctionnalité n’est pas installée.
INSTALLSTATE_ADVERTISED	La fonctionnalité est annoncée
INSTALLSTATE_LOCAL	La fonctionnalité est installée localement et disponible pour une utilisation.
INSTALLSTATE_SOURCE	La fonctionnalité est installée à partir de la source et disponible pour une utilisation.
INSTALLSTATE_UNKNOWN	La fonctionnalité n’est pas publiée.

Remarques

La fonction MsiUseFeatureEx ne doit être utilisée que sur les fonctionnalités connues pour être publiées. INSTALLSTATE_UNKNOWN indique que le programme tente d’utiliser une fonctionnalité qui n’est pas publiée. L’application doit déterminer si la fonctionnalité est publiée avant d’appeler MsiUseFeature en appelant MsiQueryFeatureState ou MsiEnumFeatures. L’application doit effectuer ces appels pendant son initialisation. Une application ne doit utiliser que des fonctionnalités connues pour être publiées.

Note

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

Application-Only Functions

Partager via