MsiSetFeatureAttributesA-Funktion (msiquery.h)

  • Artikel

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
INSTALLFEATUREATTRIBUTE_FAVORLOCAL
1
 Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesFavorLocal. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle .
INSTALLFEATUREATTRIBUTE_FAVORSOURCE
2
 Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesFavorSource. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle .
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT
4
 Ä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 .
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE
8
 Ändert die Standardfeatureattribute zur Laufzeit in msidbFeatureAttributesFavorAdvertise. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle .
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE
16
 Ändert standardfeatureattribute in msidbFeatureAttributesDisallowAdvertise zur Laufzeit. Eine Beschreibung finden Sie in der Spalte Attribute der Featuretabelle .
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE
32
 Ä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