Função MsiIsProductElevatedA (msi.h)

Artigo
11/20/2024

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 de código de produto completo do produto.

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

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS e pfElevated será definido como VERDADEIRO 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	No momento, o produto não é conhecido.
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	Falha na função.
ERROR_CALL_NOT_IMPLEMENTED	A função não está disponível para uma plataforma específica.

Observações

Nota

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. 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. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

determinando de contexto de instalação

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

Compartilhar via