Funzione MsiGetSummaryInformationA (msiquery.h)

Articolo
11/20/2024

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

Handle per 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 di informazioni di riepilogo.

Valore restituito

La funzione MsiGetSummaryInformation restituisce i valori seguenti:

Osservazioni

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, è necessario chiamare MsiSummaryInfoPersist prima di chiudere l'handle phSummaryInfo. Se non si esegue questa operazione, le informazioni sul flusso esistenti andranno perse.

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 quando escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere usare PMSIHANDLE anziché la sezione HANDLE nella Procedure consigliate di Windows Installer.

Se la funzione non riesce, è possibile ottenere informazioni estese sull'errore 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	msiquery.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

funzioni delle proprietà delle informazioni di riepilogo

set di proprietà del flusso di informazioni di riepilogo

Condividi tramite