MsiSetFeatureAttributesA-Funktion (msiquery.h)

Artikel
11/20/2024

Die MsiSetFeatureAttributes- Funktion kann die Standardattribute eines Features zur Laufzeit ändern. Beachten Sie, dass die Standardattribute von Features in der Spalte "Attribute" der Featuretabelleerstellt 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 wird, oder erhalten Sie über MsiOpenPackage, MsiOpenPackageEx-oder MsiOpenProduct-.

[in] szFeature

Gibt den Featurenamen innerhalb des Produkts an.

[in] dwAttributes

Featureattribute, die zur Laufzeit als Eine Reihe von Bitkennzeichnungen angegeben werden:

Konstante	Bedeutung
INSTALLFEATUREATTRIBUTE_FAVORLOCAL 1	Ändert standardfeatureattribute in msidbFeatureAttributesFavorLocal zur Laufzeit. Eine Beschreibung finden Sie in der Spalte "Attribute" der Featuretabelle.
INSTALLFEATUREATTRIBUTE_FAVORSOURCE 2	Ändert standardfeatureattribute zu msidbFeatureAttributesFavorSource zur Laufzeit. Eine Beschreibung finden Sie in der Spalte "Attribute" der Featuretabelle.
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT 4	Ändert standardfeatureattribute in msidbFeatureAttributesFollowParent zur Laufzeit. Beachten Sie, dass dies kein gültiges Attribut ist, das für Features auf oberster Ebene festgelegt werden soll. Eine Beschreibung finden Sie in der Spalte "Attribute" der Featuretabelle.
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE 8	Ändert standardfeatureattribute in msidbFeatureAttributesFavorAdvertise zur Laufzeit. 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 standardfeatureattribute in msidbFeatureAttributesNoUnsupportedAdvertise zur Laufzeit. Eine Beschreibung finden Sie in der Spalte "Attribute" der Featuretabelle.

Rückgabewert

Diese Funktion gibt UINT zurück.

Bemerkungen

MsiSetFeatureAttributes- muss nach CostInitialize-Aktion und vor CostFinalize-Aktionaufgerufen werden. Die Funktion gibt ERROR_FUNCTION_FAILED zurück, wenn sie zu einem anderen Zeitpunkt aufgerufen wird.

Die Kennzeichnungen INSTALLFEATUREATTRIBUTE_FAVORLOCAL, INSTALLFEATUREATTRIBUTE_FAVORSOURCE und INSTALLFEATUREATTRIBUTE_FOLLOWPARENT schließen sich gegenseitig aus. Nur eines dieser Bits kann für jedes Feature festgelegt werden. Wenn mehrere dieser Flags festgelegt sind, ist das Verhalten dieses Features nicht definiert.

Siehe Aufrufen von Datenbankfunktionen aus Programmen.

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte 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-	Fenster
Header-	msiquery.h
Library	Msi.lib
DLL-	Msi.dll

Freigeben über