Função MsiUseFeatureA (msi.h)

  • Artigo

A função MsiUseFeature incrementa a contagem de uso de um recurso específico e indica o estado de instalação desse recurso. Essa função deve ser usada para indicar a intenção de um aplicativo de usar um recurso.

Sintaxe

INSTALLSTATE MsiUseFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature
);

Parâmetros

[in] szProduct

Especifica o código do produto para o produto que possui o recurso a ser usado.

[in] szFeature

Identifica o recurso a ser usado.

Valor retornado

Valor Significado
INSTALLSTATE_ABSENT
 O recurso não é instalado.
INSTALLSTATE_ADVERTISED
 O recurso é anunciado
INSTALLSTATE_BADCONFIG
 Os dados de configuração estão corrompidos.
INSTALLSTATE_INVALIDARG
 Argumento de função inválido.
INSTALLSTATE_LOCAL
 O recurso está instalado localmente e disponível para uso.
INSTALLSTATE_SOURCE
 O recurso é instalado da origem e está disponível para uso.
INSTALLSTATE_UNKNOWN
 O recurso não foi publicado.
 
 

Comentários

A função MsiUseFeature só deve ser usada em recursos conhecidos por serem publicados. INSTALLSTATE_UNKNOWN indica que o programa está tentando usar um recurso que não está publicado. O aplicativo deve determinar se o recurso é publicado antes de chamar MsiUseFeature chamando MsiQueryFeatureState ou MsiEnumFeatures. O aplicativo deve fazer essas chamadas enquanto inicializa. Um aplicativo só deve usar recursos que são conhecidos por serem publicados.

Observação

O cabeçalho msi.h define MsiUseFeature 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. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
Plataforma de Destino Windows
Cabeçalho msi.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções somente do aplicativo