MsiSetFeatureAttributesA-Funktion (msiquery.h)
Die MsiSetFeatureAttributes-Funktion kann die Standardattribute eines Features zur Laufzeit ändern. Beachten Sie, dass die Standardattribute von Features in der Spalte Attribute der Featuretabelle erstellt werden.
Syntax
UINT MsiSetFeatureAttributesA(
[in] MSIHANDLE hInstall,
[in] LPCSTR szFeature,
[in] DWORD dwAttributes
);
Parameter
[in] hInstall
Behandeln Sie die Installation, die für eine benutzerdefinierte DLL-Aktion bereitgestellt oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.
[in] szFeature
Gibt den Featurenamen innerhalb des Produkts an.
[in] dwAttributes
Featureattribute, die zur Laufzeit als Eine Reihe von Bitflags angegeben werden:
Konstante | Bedeutung |
---|---|
|
Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesFavorLocal. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle . |
|
Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesFavorSource. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle . |
|
Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesFollowParent. Beachten Sie, dass dies kein gültiges Attribut ist, das für Features der obersten Ebene festgelegt werden muss. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle . |
|
Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesFavorAdvertise. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle . |
|
Ändert standardfeatureattribute in msidbFeatureAttributesDisallowAdvertise zur Laufzeit. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle . |
|
Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesNoUnsupportedAdvertise. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle . |
Rückgabewert
Diese Funktion gibt UINT zurück.
Hinweise
MsiSetFeatureAttributes muss nach der CostInitialize-Aktion und vor der CostFinalize-Aktion aufgerufen werden. Die Funktion gibt ERROR_FUNCTION_FAILED zurück, wenn sie zu einem anderen Zeitpunkt aufgerufen wird.
Die flags INSTALLFEATUREATTRIBUTE_FAVORLOCAL, INSTALLFEATUREATTRIBUTE_FAVORSOURCE und INSTALLFEATUREATTRIBUTE_FOLLOWPARENT schließen sich gegenseitig aus. Nur eines dieser Bits kann für ein beliebiges Feature festgelegt werden. Wenn mehrere dieser Flags festgelegt sind, ist das Verhalten dieses Features nicht definiert.
Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.
Hinweis
Der msiquery.h-Header definiert MsiSetFeatureAttributes als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP |
Zielplattform | Windows |
Kopfzeile | msiquery.h |
Bibliothek | Msi.lib |
DLL | Msi.dll |