Função MsiGetFeatureStateW (msiquery.h)

Artigo
11/20/2024

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

Sintaxe

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

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.

[out] piInstalled

Especifica o estado atual instalado retornado. Esse parâmetro não deve ser nulo. Esse parâmetro pode ser 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á interrompido.
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 de origem.

[out] piAction

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

Valor de retorno

A função MsiGetFeatureState retorna os seguintes valores:

Observações

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.

Nota

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 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

Consulte também

Funções de seleção do instalador

passando nulo como o argumento do Windows Installer Functions

Compartilhar via