MsiGetSummaryInformationA-Funktion (msiquery.h)

Artikel
08/25/2023

Die MsiGetSummaryInformation-Funktion ruft ein Handle für den _SummaryInformation-Stream für eine Installationsdatenbank ab. Diese Funktion gibt ein Handle zurück, das mit MsiCloseHandle geschlossen werden soll.

Syntax

UINT MsiGetSummaryInformationA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szDatabasePath,
  [in]  UINT      uiUpdateCount,
  [out] MSIHANDLE *phSummaryInfo
);

Parameter

[in] hDatabase

Handle für die Datenbank.

[in] szDatabasePath

Gibt den Pfad zur Datenbank an.

[in] uiUpdateCount

Gibt die maximale Anzahl aktualisierter Werte an.

[out] phSummaryInfo

Zeiger auf den Speicherort, von dem das Zusammenfassungsinformationshandle empfangen werden soll.

Rückgabewert

Die MsiGetSummaryInformation-Funktion gibt die folgenden Werte zurück:

Hinweise

Wenn die durch die MsiGetSummaryInformation-Funktion angegebene Datenbank nicht geöffnet ist, müssen Sie 0 für hDatabase und den Pfad zur Datenbank in szDatabasePath angeben. Wenn die Datenbank geöffnet ist, müssen Sie szDatabasePath auf 0 festlegen.

Wenn ein Wert von uiUpdateCount größer als 0 zum Öffnen eines vorhandenen Zusammenfassungsinformationsdatenstroms verwendet wird, muss MsiSummaryInfoPersist aufgerufen werden, bevor das phSummaryInfo-Handle geschlossen wird. Andernfalls gehen die vorhandenen Datenstrominformationen verloren.

Um die Zusammenfassungsinformationen eines Patches mithilfe von MsiGetSummaryInformation anzuzeigen, legen Sie szDatabasePath auf den Pfad zum Patch fest. Alternativ können Sie mithilfe von MsiOpenDatabase ein Handle für den Patch erstellen und dieses Handle dann als hDatabase-Parameter an MsiGetSummaryInformation übergeben.

Beachten Sie, dass die Verwendung von Variablen vom Typ PMSIHANDLE empfohlen wird, da das Installationsprogramm PMSIHANDLE-Objekte schließt, wenn sie den Gültigkeitsbereich sprengen, während Sie MSIHANDLE-Objekte durch Aufrufen von MsiCloseHandle schließen müssen. Weitere Informationen finden Sie im Abschnitt Verwenden von PMSIHANDLE anstelle von HANDLE im Abschnitt Bewährte Methoden für Windows Installer.

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.

Hinweis

Der msiquery.h-Header definiert MsiGetSummaryInformation als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP
Zielplattform	Windows
Kopfzeile	msiquery.h
Bibliothek	Msi.lib
DLL	Msi.dll

Weitere Informationen

Eigenschaftenfunktionen für Zusammenfassungsinformationen

Eigenschaftensatz für den zusammenfassenden Informationsdatenstrom

Freigeben über