Função MsiSetFeatureAttributesW (msiquery.h)

Artigo
11/20/2024

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 de recursos .

Sintaxe

UINT MsiSetFeatureAttributesW(
  [in] MSIHANDLE hInstall,
  [in] LPCWSTR   szFeature,
  [in] DWORD     dwAttributes
);

Parâmetros

[in] hInstall

Manipule a instalação fornecida para uma ação personalizada de DLL ou obtida por meio MsiOpenPackage, MsiOpenPackageExou 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 Feature 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 Feature para obter uma descrição.
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT 4	Modifica atributos de recurso padrão para msidbFeatureAttributesFollowParent em tempo de execução. Observe que este não é um atributo válido a ser definido para recursos de nível superior. Consulte a coluna Atributos da tabela Feature para obter uma descrição.
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE 8	Modifica atributos de recurso padrão para msidbFeatureAttributesFavorAdvertise em tempo de execução. Consulte a coluna Atributos da tabela Feature para obter uma descrição.
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE 16	Modifica atributos de recurso padrão para msidbFeatureAttributesDisallowAdvertise em tempo de execução. Consulte a coluna Atributos da tabela Feature para obter uma descrição.
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE 32	Modifica os atributos de recurso padrão para msidbFeatureAttributesNoUnsupportedAdvertise em tempo de execução. Consulte a coluna Atributos da tabela Feature para obter uma descrição.

Valor de retorno

Essa função retorna UINT.

Observações

msiSetFeatureAttributes deve ser chamado após de ação CostInitialize e antes de de ação CostFinalize. A função retorna ERROR_FUNCTION_FAILED se 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Compartilhar via