Funzione MsiGetSummaryInformationA (msiquery.h)
La funzione MsiGetSummaryInformation ottiene un handle per il flusso _SummaryInformation per un database del programma di installazione. Questa funzione restituisce un handle che deve essere chiuso usando MsiCloseHandle.
Sintassi
UINT MsiGetSummaryInformationA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szDatabasePath,
[in] UINT uiUpdateCount,
[out] MSIHANDLE *phSummaryInfo
);
Parametri
[in] hDatabase
Gestire il database.
[in] szDatabasePath
Specifica il percorso del database.
[in] uiUpdateCount
Specifica il numero massimo di valori aggiornati.
[out] phSummaryInfo
Puntatore alla posizione da cui ricevere l'handle delle informazioni di riepilogo.
Valore restituito
La funzione MsiGetSummaryInformation restituisce i valori seguenti:
Commenti
Se il database specificato dalla funzione MsiGetSummaryInformation non è aperto, è necessario specificare 0 per hDatabase e specificare il percorso del database in szDatabasePath. Se il database è aperto, è necessario impostare szDatabasePath su 0.
Se viene usato un valore di uiUpdateCount maggiore di 0 per aprire un flusso di informazioni di riepilogo esistente, MsiSummaryInfoPersist deve essere chiamato prima di chiudere l'handle phSummaryInfo . Questa operazione non riesce a perdere le informazioni di flusso esistenti.
Per visualizzare le informazioni di riepilogo di una patch usando MsiGetSummaryInformation, impostare szDatabasePath sul percorso della patch. In alternativa, è possibile creare un handle per la patch usando MsiOpenDatabase e quindi passare tale handle a MsiGetSummaryInformation come parametro hDatabase .
Si noti che è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE mentre escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere Usare PMSIHANDLE anziché la sezione HANDLE nelle procedure consigliate di Windows Installer.
Se la funzione ha esito negativo, è possibile ottenere informazioni di errore estese usando MsiGetLastErrorRecord.
Nota
L'intestazione msiquery.h definisce MsiGetSummaryInformation come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP |
| Piattaforma di destinazione | Windows |
| Intestazione | msiquery.h |
| Libreria | Msi.lib |
| DLL | Msi.dll |