Função MsiEvaluateConditionW (msiquery.h)

A função MsiEvaluateCondition avalia uma expressão condicional que contém nomes de propriedade e valores.

Sintaxe

MSICONDITION MsiEvaluateConditionW(
  [in] MSIHANDLE hInstall,
  [in] LPCWSTR   szCondition
);

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

Especifica a expressão condicional. Esse parâmetro não deve ser NULL. Para obter a sintaxe de expressões condicionais, consulte Sintaxe de instrução condicional.

Retornar valor

Essa função retorna MSICONDITION.

Comentários

A tabela a seguir mostra os valores de estado do recurso e do componente usados pela função MsiEvaluateCondition . Esses estados não são definidos até que MsiSetInstallLevel seja chamado, diretamente ou pela ação CostFinalize. Portanto, a verificação de estado geralmente só é útil para expressões condicionais em uma tabela de sequência de ações.

Valor	Significado
INSTALLSTATE_ABSENT	Recurso ou componente não presente.
INSTALLSTATE_LOCAL	Recurso ou componente no computador local.
INSTALLSTATE_SOURCE	Recurso ou componente executado da origem.
(valor nulo)	Nenhuma ação a ser executada no recurso ou componente.

 

 

Observação

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

Confira também

Funções de ação do instalador

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