Função MsiIsProductElevatedA (msi.h)
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 |
|---|---|
|
O produto não é conhecido no momento. |
|
Um argumento inválido é passado para a função . |
|
As informações de configuração do produto são inválidas. |
|
A função falhou. |
|
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