Compartilhar via

Função MsiOpenPackageExW (msi.h)

  • Artigo

A função MsiOpenPackageEx abre um pacote a ser usado com funções que acessam o banco de dados do produto. A função MsiCloseHandle deve ser chamada com o identificador quando o identificador não é mais necessário.

Observação Inicializar COM no mesmo thread antes de chamar a função MsiOpenPackage, MsiOpenPackageExou msiOpenProduct.

 

Sintaxe

UINT MsiOpenPackageExW(
  [in]  LPCWSTR   szPackagePath,
  [in]  DWORD     dwOptions,
  [out] MSIHANDLE *hProduct
);

Parâmetros

[in] szPackagePath

O caminho para o pacote.

[in] dwOptions

Os sinalizadores de bits para indicar se o estado do computador deve ou não ser ignorado. Passe 0 (zero) para usar comportamento de MsiOpenPackage.

Constante Significado
MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE
1
 Ignore o estado do computador ao criar o identificador do produto.

[out] hProduct

Um ponteiro para uma variável que recebe o identificador do produto.

Valor de retorno

Valor Significado
ERROR_BAD_CONFIGURATION
 As informações de configuração estão corrompidas.
ERROR_INSTALL_FAILURE
 Não foi possível abrir o produto.
ERROR_INSTALL_REMOTE_PROHIBITED
 O Windows Installer não permite a instalação de uma conexão de área de trabalho remota.
ERROR_INVALID_PARAMETER
 Um parâmetro inválido é passado para a função.
ERROR_SUCCESS
 A função é concluída com êxito.
 

Se essa função falhar, ela poderá retornar um código de erro do sistema. Para obter mais informações, consulte códigos de erro do sistema.

Observações

Para criar um identificador de produto restrito que seja independente do estado do computador atual e incapaz de alterar o estado atual do computador, use MsiOpenPackageEx com MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE definido em dwOptions.

Observe que se dwOptions for MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE ou 1, MsiOpenPackageEx ignorará o estado do computador atual ao criar o identificador do produto. Se o valor de dwOptions for 0, MsiOpenPackageEx será o mesmo que MsiOpenPackage e criará um identificador de produto que depende se o pacote especificado por szPackagePath já estiver instalado no computador.

O identificador restrito criado usando MsiOpenPackageEx com MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE só permite a execução de caixas de diálogo, um subconjunto das ações padrão e ações personalizadas que definem propriedades (tipo de ação personalizada 35, tipo de ação personalizada 51e tipo de ação personalizada 19). O identificador restrito impede o uso de ações personalizadas que executam bibliotecas Dynamic-Link, arquivos executáveis ou scripts .

Você pode chamar msiDoAction nas seguintes ações padrão usando o identificador restrito. Todas as outras ações retornam ERROR_FUNCTION_NOT_CALLED se chamadas com o identificador restrito.

A função MsiCloseHandle deve ser chamada quando o identificador não é necessário.

Nota

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