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.

Requisitos

Confira também

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

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