Funzione MsiSetFeatureAttributesA (msiquery.h)

Articolo
11/20/2024

La funzione MsiSetFeatureAttributes può modificare gli attributi predefiniti di una funzionalità in fase di esecuzione. Si noti che gli attributi predefiniti delle funzionalità vengono creati nella colonna Attributi della tabella Feature.

Sintassi

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

Parametri

[in] hInstall

Gestire l'installazione fornita a un'azione personalizzata DLL o ottenuta tramite MsiOpenPackage, MsiOpenPackageExo MsiOpenProduct.

[in] szFeature

Specifica il nome della funzionalità all'interno del prodotto.

[in] dwAttributes

Attributi di funzionalità specificati in fase di esecuzione come set di flag di bit:

Costante	Significato
INSTALLFEATUREATTRIBUTE_FAVORLOCAL 1	Modifica gli attributi di funzionalità predefiniti in msidbFeatureAttributesFavorLocal in fase di esecuzione. Per una descrizione, vedere la colonna Attributi della tabella Feature.
INSTALLFEATUREATTRIBUTE_FAVORSOURCE 2	Modifica gli attributi di funzionalità predefiniti in msidbFeatureAttributesFavorSource in fase di esecuzione. Per una descrizione, vedere la colonna Attributi della tabella Feature.
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT 4	Modifica gli attributi di funzionalità predefiniti in msidbFeatureAttributesFollowParent in fase di esecuzione. Si noti che questo attributo non è valido da impostare per le funzionalità di primo livello. Per una descrizione, vedere la colonna Attributi della tabella Feature.
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE 8	Modifica gli attributi di funzionalità predefiniti in msidbFeatureAttributesFavorAdvertise in fase di esecuzione. Per una descrizione, vedere la colonna Attributi della tabella Feature.
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE 16	Modifica gli attributi di funzionalità predefiniti in msidbFeatureAttributesDisallowAdvertise in fase di esecuzione. Per una descrizione, vedere la colonna Attributi della tabella Feature.
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE 32	Modifica gli attributi di funzionalità predefiniti in msidbFeatureAttributesNoUnsupportedAdvertise in fase di esecuzione. Per una descrizione, vedere la colonna Attributi della tabella Feature.

Valore restituito

Questa funzione restituisce UINT.

Osservazioni

MsiSetFeatureAttributes deve essere chiamato dopo 'azione CostInitialize e prima 'azione CostFinalize. La funzione restituisce ERROR_FUNCTION_FAILED se viene chiamato in qualsiasi altro momento.

I flag INSTALLFEATUREATTRIBUTE_FAVORLOCAL, INSTALLFEATUREATTRIBUTE_FAVORSOURCE e INSTALLFEATUREATTRIBUTE_FOLLOWPARENT si escludono a vicenda. Solo uno di questi bit può essere impostato per qualsiasi funzionalità. Se sono impostati più flag, il comportamento di tale funzionalità non è definito.

Vedere Chiamata di funzioni di database da programmi.

Nota

L'intestazione msiquery.h definisce MsiSetFeatureAttributes come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP
piattaforma di destinazione	Finestre
intestazione	msiquery.h
libreria	Msi.lib
dll	Msi.dll

Condividi tramite