Função MsiOpenPackageExA (msi.h)

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.

Sintaxe

UINT MsiOpenPackageExA(
  [in]  LPCSTR    szPackagePath,
  [in]  DWORD     dwOptions,
  [out] MSIHANDLE *hProduct
);

Parâmetros

[in] szPackagePath

O caminho para o pacote.

[in] dwOptions

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

[out] hProduct

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

Valor retornado

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.

Comentários

Para criar um identificador de produto restrito 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 atual do computador 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á está instalado no computador.

O identificador restrito criado usando MsiOpenPackageEx com MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE permite apenas 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 51 e Tipo de Ação Personalizada 19). O identificador restrito impede o uso de ações personalizadas que executam Bibliotecas de Link Dinâmico, 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 forem chamadas com o identificador restrito.

• ADMIN
• ADVERTISE
• INSTALL
• SEQUENCE
• Ação AppSearch
• CCPSearch
• CostFinalize
• CostInitialize
• FileCost
• FindRelatedProducts
• Ação IsolateComponents
• LaunchConditions
• MigrateFeatureStates
• ResolveSource
• RMCCPSearch
• ValidateProductID

Requisitos