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 |