Funzione MsiGetSummaryInformationA (msiquery.h)

  • Articolo

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

Vedi anche

Funzioni delle proprietà Di riepilogo delle informazioni

Riepilogo informazioni Stream set di proprietà