MsiSetFeatureAttributesA, fonction (msiquery.h)

Article
11/20/2024

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 de fonctionnalités .

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, MsiOpenPackageExou 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 en tant qu’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. Consultez la colonne Attributs de la table de fonctionnalités pour obtenir une description.
INSTALLFEATUREATTRIBUTE_FAVORSOURCE 2	Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesFavorSource au moment de l’exécution. Consultez la colonne Attributs de la table de fonctionnalités pour obtenir une description.
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. Consultez la colonne Attributs de la table de fonctionnalités pour obtenir une description.
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE 8	Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesFavorAdvertise au moment de l’exécution. Consultez la colonne Attributs de la table de fonctionnalités pour obtenir une description.
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE 16	Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesDisallowAdvertise au moment de l’exécution. Consultez la colonne Attributs de la table de fonctionnalités pour obtenir une description.
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE 32	Modifie les attributs de fonctionnalité par défaut en msidbFeatureAttributesNoUnsupportedAdvertise au moment de l’exécution. Consultez la colonne Attributs de la table de fonctionnalités pour obtenir une description.

Valeur de retour

Cette fonction retourne UINT.

Remarques

MsiSetFeatureAttributes doit être appelée après 'action CostInitialize et avant action CostFinalize. La fonction retourne ERROR_FUNCTION_FAILED si elle est appelée à tout 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 appels de fonctions de base de données à partir de programmes.

Note

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

Partager via