Função MsiIsProductElevatedA (msi.h)

  • Artigo

A função MsiIsProductElevated retorna se o produto é gerenciado ou não. Somente os aplicativos que exigem privilégios elevados para instalação e que estão sendo instalados por meio de anúncio são considerados gerenciados, o que significa que um aplicativo instalado por computador é sempre considerado gerenciado.

Um aplicativo instalado por usuário só será considerado gerenciado se for anunciado por um processo do sistema local que representa o usuário. Para obter mais informações, consulte Anunciando um aplicativo Per-User a ser instalado com privilégios elevados.

MsiIsProductElevated verifica se o sistema local possui os dados do registro do produto. A função não se refere a políticas de conta, como AlwaysInstallElevated.

Sintaxe

UINT MsiIsProductElevatedA(
  [in]  LPCSTR szProduct,
  [out] BOOL   *pfElevated
);

Parâmetros

[in] szProduct

O GUID do código de produto completo.

Esse parâmetro é necessário e não pode ser NULL ou vazio.

[out] pfElevated

Um ponteiro para um BOOL para o resultado.

Esse parâmetro não pode ser NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS e pfElevated será definido como TRUE se o produto for um aplicativo gerenciado.

Se a função falhar, o valor retornado será um dos códigos de erro identificados na tabela a seguir.

Código de retorno Descrição
ERROR_UNKNOWN_PRODUCT
 O produto não é conhecido no momento.
ERROR_INVALID_PARAMETER
 Um argumento inválido é passado para a função .
ERROR_BAD_CONFIGURATION
 As informações de configuração do produto são inválidas.
ERROR_FUNCTION_FAILED
 A função falhou.
ERROR_CALL_NOT_IMPLEMENTED
 A função não está disponível para uma plataforma específica.

Comentários

Observação

O cabeçalho msi.h define MsiIsProductElevated 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

Determinar o contexto de instalação

Como instalar um pacote com privilégios elevados para um não administrador