MsiGetSummaryInformationA-Funktion (msiquery.h)

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

Syntax

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

Parameter

[in] hDatabase

Behandeln Sie die Datenbank.

[in] szDatabasePath

Gibt den Pfad zur Datenbank an.

[in] uiUpdateCount

Gibt die maximale Anzahl aktualisierter Werte an.

[out] phSummaryInfo

Zeigen Sie auf die Position, von der aus das Zusammenfassungsinformationshandle empfangen werden soll.

Rückgabewert

Die MsiGetSummaryInformation Funktion gibt die folgenden Werte zurück:

Bemerkungen

Wenn die durch die MsiGetSummaryInformation Funktion angegebene Datenbank nicht geöffnet ist, müssen Sie 0 für hDatabase- angeben und den Pfad zur Datenbank in szDatabasePathangeben. 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.

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

Beachten Sie, dass es empfohlen wird, Variablen vom Typ PMSIHANDLE zu verwenden, da das Installationsprogramm PMSIHANDLE-Objekte schließt, während sie außerhalb des Gültigkeitsbereichs liegen, während Sie MSIHANDLE-Objekte schließen müssen, indem Sie MsiCloseHandleaufrufen. Weitere Informationen finden Sie unter Verwenden von PMSIHANDLE anstelle des Abschnitts HANDLE im bewährte Methoden für Windows Installer.

Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe MsiGetLastErrorRecordabrufen.

Anforderungen

Siehe auch

Funktionen für zusammenfassungsinformationen

Eigenschaftensatz "Zusammenfassungsinformationen stream"