Função MsiSetFeatureAttributesA (msiquery.h)

  • Artigo

A função MsiSetFeatureAttributes pode modificar os atributos padrão de um recurso em runtime. Observe que os atributos padrão dos recursos são criados na coluna Atributos da tabela Feature.

Sintaxe

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

Parâmetros

[in] hInstall

Manipule para a instalação fornecida a uma ação personalizada de DLL ou obtida por meio de MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] szFeature

Especifica o nome do recurso dentro do produto.

[in] dwAttributes

Atributos de recurso especificados em tempo de execução como um conjunto de sinalizadores de bits:

Constante Significado
INSTALLFEATUREATTRIBUTE_FAVORLOCAL
1
 Modifica os atributos de recurso padrão para msidbFeatureAttributesFavorLocal em tempo de execução. Consulte a coluna Atributos da tabela De recursos para obter uma descrição.
INSTALLFEATUREATTRIBUTE_FAVORSOURCE
2
 Modifica os atributos de recurso padrão para msidbFeatureAttributesFavorSource em tempo de execução. Consulte a coluna Atributos da tabela De recursos para obter uma descrição.
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT
4
 Modifica os atributos de recurso padrão para msidbFeatureAttributesFollowParent em tempo de execução. Observe que esse não é um atributo válido a ser definido para recursos de nível superior. Consulte a coluna Atributos da tabela De recursos para obter uma descrição.
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE
8
 Modifica os atributos de recurso padrão para msidbFeatureAttributesFavorAdvertise em tempo de execução. Consulte a coluna Atributos da tabela De recursos para obter uma descrição.
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE
16
 Modifica os atributos de recurso padrão para msidbFeatureAttributesDisallowAdvertise em tempo de execução. Consulte a coluna Atributos da tabela De recursos para obter uma descrição.
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE
32
 Modifica atributos de recurso padrão para msidbFeatureAttributesNoUnsupportedAdvertise em tempo de execução. Consulte a coluna Atributos da tabela De recursos para obter uma descrição.

Retornar valor

Essa função retorna UINT.

Comentários

MsiSetFeatureAttributes deve ser chamado após a ação CostInitialize e antes da ação CostFinalize. A função retorna ERROR_FUNCTION_FAILED se for chamada em qualquer outro momento.

Os sinalizadores INSTALLFEATUREATTRIBUTE_FAVORLOCAL, INSTALLFEATUREATTRIBUTE_FAVORSOURCE e INSTALLFEATUREATTRIBUTE_FOLLOWPARENT são mutuamente exclusivos. Somente um desses bits pode ser definido para qualquer recurso. Se mais de um desses sinalizadores estiver definido, o comportamento desse recurso será indefinido.

Consulte Chamando funções de banco de dados de programas.

Observação

O cabeçalho msiquery.h define MsiSetFeatureAttributes como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
Plataforma de Destino Windows
Cabeçalho msiquery.h
Biblioteca Msi.lib
DLL Msi.dll