Compartilhar via


Função MsiGetSummaryInformationA (msiquery.h)

A função MsiGetSummaryInformation obtém um identificador para o fluxo de _SummaryInformation para um banco de dados do instalador. Essa função retorna um identificador que deve ser fechado usando MsiCloseHandle.

Sintaxe

UINT MsiGetSummaryInformationA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szDatabasePath,
  [in]  UINT      uiUpdateCount,
  [out] MSIHANDLE *phSummaryInfo
);

Parâmetros

[in] hDatabase

Manipule para o banco de dados.

[in] szDatabasePath

Especifica o caminho para o banco de dados.

[in] uiUpdateCount

Especifica o número máximo de valores atualizados.

[out] phSummaryInfo

Ponteiro para o local do qual receber o identificador de informações de resumo.

Retornar valor

A função MsiGetSummaryInformation retorna os seguintes valores:

Comentários

Se o banco de dados especificado pela função MsiGetSummaryInformation não estiver aberto, você deverá especificar 0 para hDatabase e especificar o caminho para o banco de dados em szDatabasePath. Se o banco de dados estiver aberto, você deverá definir szDatabasePath como 0.

Se um valor de uiUpdateCount maior que 0 for usado para abrir um fluxo de informações de resumo existente, MsiSummaryInfoPersist deverá ser chamado antes de fechar o identificador phSummaryInfo . Não fazer isso perderá as informações de fluxo existentes.

Para exibir as informações resumidas de um patch usando MsiGetSummaryInformation, defina szDatabasePath como o caminho para o patch. Como alternativa, você pode criar um identificador para o patch usando MsiOpenDatabase e, em seguida, passar esse identificador para MsiGetSummaryInformation como o parâmetro hDatabase .

Observe que é recomendável usar variáveis do tipo PMSIHANDLE porque o instalador fecha objetos PMSIHANDLE à medida que eles saem do escopo, enquanto você deve fechar objetos MSIHANDLE chamando MsiCloseHandle. Para obter mais informações, confira a seção Use PMSIHANDLE em vez de HANDLE nas Melhores práticas do Windows Installer.

Se a função falhar, você poderá obter informações de erro estendidas usando MsiGetLastErrorRecord.

Observação

O cabeçalho msiquery.h define MsiGetSummaryInformation 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

Requisito Valor
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
Plataforma de Destino Windows
Cabeçalho msiquery.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções de propriedade de informações de resumo

Conjunto de propriedades de fluxo de informações de resumo