MsiSetFeatureAttributesA, fonction (msiquery.h)

  • Article

La fonction MsiSetFeatureAttributes peut modifier les attributs par défaut d’une fonctionnalité au moment de l’exécution. Notez que les attributs par défaut des fonctionnalités sont créés dans la colonne Attributs de la table Fonctionnalité.

Syntaxe

UINT MsiSetFeatureAttributesA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szFeature,
  [in] DWORD     dwAttributes
);

Paramètres

[in] hInstall

Gérez l’installation fournie à une action personnalisée DLL ou obtenue via MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] szFeature

Spécifie le nom de la fonctionnalité dans le produit.

[in] dwAttributes

Attributs de fonctionnalité spécifiés au moment de l’exécution sous la forme d’un ensemble d’indicateurs de bits :

Constant Signification
INSTALLFEATUREATTRIBUTE_FAVORLOCAL
1
 Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesFavorLocal au moment de l’exécution. Pour obtenir une description, consultez La colonne Attributs de la table Feature .
INSTALLFEATUREATTRIBUTE_FAVORSOURCE
2
 Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesFavorSource au moment de l’exécution. Pour obtenir une description, consultez La colonne Attributs de la table Feature .
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT
4
 Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesFollowParent au moment de l’exécution. Notez qu’il ne s’agit pas d’un attribut valide à définir pour les fonctionnalités de niveau supérieur. Pour obtenir une description, consultez La colonne Attributs de la table Feature .
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE
8
 Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesFavorAdvertise au moment de l’exécution. Pour obtenir une description, consultez La colonne Attributs de la table Feature .
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE
16
 Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesDisallowAdvertise au moment de l’exécution. Pour obtenir une description, consultez La colonne Attributs de la table Feature .
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE
32
 Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesNoUnsupportedAdvertise au moment de l’exécution. Pour obtenir une description, consultez La colonne Attributs de la table Feature .

Valeur retournée

Cette fonction retourne UINT.

Remarques

MsiSetFeatureAttributes doit être appelé après l’action CostInitialize et avant l’action CostFinalize. La fonction retourne ERROR_FUNCTION_FAILED si elle est appelée à un autre moment.

Les indicateurs INSTALLFEATUREATTRIBUTE_FAVORLOCAL, INSTALLFEATUREATTRIBUTE_FAVORSOURCE et INSTALLFEATUREATTRIBUTE_FOLLOWPARENT s’excluent mutuellement. Un seul de ces bits peut être défini pour n’importe quelle fonctionnalité. Si plusieurs de ces indicateurs sont définis, le comportement de cette fonctionnalité n’est pas défini.

Consultez Appel de fonctions de base de données à partir de programmes.

Notes

L’en-tête msiquery.h définit MsiSetFeatureAttributes 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
Plateforme cible Windows
En-tête msiquery.h
Bibliothèque Msi.lib
DLL Msi.dll