MsiUseFeatureA, fonction (msi.h)

  • Article

La fonction MsiUseFeature 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 MsiUseFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature
);

Paramètres

[in] szProduct

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

[in] szFeature

Identifie la fonctionnalité à utiliser.

Valeur retournée

Valeur Signification
INSTALLSTATE_ABSENT
 La fonctionnalité n’est pas installée.
INSTALLSTATE_ADVERTISED
 La fonctionnalité est annoncée
INSTALLSTATE_BADCONFIG
 Les données de configuration sont endommagées.
INSTALLSTATE_INVALIDARG
 Argument de fonction non valide.
INSTALLSTATE_LOCAL
 La fonctionnalité est installée localement et peut être utilisée.
INSTALLSTATE_SOURCE
 La fonctionnalité est installée à partir de la source et peut être utilisée.
INSTALLSTATE_UNKNOWN
 La fonctionnalité n’est pas publiée.
 
 

Remarques

La fonction MsiUseFeature doit être utilisée uniquement 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 doit uniquement utiliser des fonctionnalités connues pour être publiées.

Notes

L’en-tête msi.h définit MsiUseFeature en tant qu’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. La combinaison 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.

Configuration requise

Condition requise Valeur
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 spécifiques à l’application