Função MsiUseFeatureExA (msi.h)

  • Artigo

A função MsiUseFeatureEx 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 MsiUseFeatureExA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwInstallMode,
  [in] DWORD  dwReserved
);

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.

[in] dwInstallMode

Esse parâmetro pode ter o valor a seguir.

Valor Significado
INSTALLMODE_NODETECTION
 O valor retornado indica o estado de instalação.

[in] dwReserved

Reservado para uso futuro. Esse valor deve ser definido como 0.

Valor retornado

Valor Significado
INSTALLSTATE_ABSENT
 O recurso não é instalado.
INSTALLSTATE_ADVERTISED
 O recurso é anunciado
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 MsiUseFeatureEx 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 MsiUseFeatureEx 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

   
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