Função MsiGetFeatureStateA (msiquery.h)

  • Artigo

A função MsiGetFeatureState obtém o estado solicitado de um recurso.

Sintaxe

UINT MsiGetFeatureStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szFeature,
  [out] INSTALLSTATE *piInstalled,
  [out] INSTALLSTATE *piAction
);

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.

[out] piInstalled

Especifica o estado atual instalado retornado. Esse parâmetro não deve ser null. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
INSTALLSTATE_BADCONFIG
 Os dados de configuração estão corrompidos.
INSTALLSTATE_INCOMPLETE
 A instalação está suspensa ou em andamento.
INSTALLSTATE_SOURCEABSENT
 O recurso deve ser executado na origem e a origem não está disponível.
INSTALLSTATE_MOREDATA
 O buffer de retorno está cheio.
INSTALLSTATE_INVALIDARG
 Um parâmetro inválido foi passado para a função.
INSTALLSTATE_UNKNOWN
 Um produto ou recurso não reconhecido foi especificado.
INSTALLSTATE_BROKEN
 O recurso está desfeito.
INSTALLSTATE_ADVERTISED
 O recurso anunciado.
INSTALLSTATE_ABSENT
 O recurso foi desinstalado.
INSTALLSTATE_LOCAL
 O recurso foi instalado na unidade local.
INSTALLSTATE_SOURCE
 O recurso deve ser executado na origem, CD-ROM ou rede.
INSTALLSTATE_DEFAULT
 O recurso é instalado no local padrão: local ou origem.

[out] piAction

Recebe a ação executada durante a sessão de instalação. Esse parâmetro não deve ser null. Para obter valores retornados, consulte piInstalled.

Valor retornado

A função MsiGetFeatureState retorna os seguintes valores:

Comentários

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

Se a função falhar, você poderá obter informações de erro estendidas usando MsiGetLastErrorRecord.

Observação

O cabeçalho msiquery.h define MsiGetFeatureState 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
Plataforma de Destino Windows
Cabeçalho msiquery.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções de seleção do instalador

Passando Null como o argumento das funções do Windows Installer