Méthode Product.FeatureState

La propriété FeatureState est l’état d’installation de la fonctionnalité pour l’instance de ce produit.

Cette propriété appelle MsiQueryFeatureStateEx, avec le ProductCode, UserSid et Context de l’objet. L’ID de fonctionnalité est fournie en tant que paramètre.

Syntaxe

Product.FeatureState(
  FeatureId
)

Paramètres

FeatureId

ID de fonctionnalité apparaissant dans la colonne Fonctionnalité de la table de caractéristiques.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Si l’appel réussit, la propriété contient la valeur en tant que DWORD.

State Signification
INSTALLSTATE_ADVERTISED Cette fonctionnalité est annoncée.
INSTALLSTATE_LOCAL La fonctionnalité est installée localement.
INSTALLSTATE_SOURCE La fonctionnalité est installée pour s’exécuter à partir de la source.

 

Si l’appel échoue, la propriété contient un code d’erreur de MsiQueryFeatureStateEx.

Error Signification
ERROR_ACCESS_DENIED Le processus appelant doit disposer de privilèges administratifs pour obtenir des informations sur un produit installé pour un utilisateur autre que l’utilisateur actuel.
ERROR_BAD_CONFIGURATION Les données de configuration sont endommagées.
ERROR_INVALID_PARAMETER Un paramètre non valide a été transmis à la fonction.
ERROR_SUCCESS La fonction s’est terminée avec succès.
ERROR_UNKNOWN_FEATURE L’ID de fonctionnalité n’identifie pas une fonctionnalité connue.
ERROR_UNKNOWN_PRODUCT Le code de produit n’identifie pas un produit connu.
ERROR_FUNCTION_FAILED Défaillance interne inattendue.

 

Configuration requise

Condition requise Valeur
Version
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 3.0 (ou version ultérieure) sur Windows Server 2003, Windows XP et Windows 2000.
DLL
Msi.dll
IID
IID_IProduct est défini comme 000C10A0-0000-0000-C000-000000000046.

Voir aussi

Produit

MsiQueryFeatureStateEx

Non pris en charge dans Windows Installer 2.0 et versions antérieures