Função MsiGetFeatureStateA (msiquery.h)

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