Функция MsiGetSummaryInformationA (msiquery.h)
Функция MsiGetSummaryInformation получает дескриптор потока _SummaryInformation для базы данных установщика. Эта функция возвращает дескриптор, который должен быть закрыт с помощью MsiCloseHandle.
Синтаксис
UINT MsiGetSummaryInformationA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szDatabasePath,
[in] UINT uiUpdateCount,
[out] MSIHANDLE *phSummaryInfo
);
Параметры
[in] hDatabase
Обработка базы данных.
[in] szDatabasePath
Указывает путь к базе данных.
[in] uiUpdateCount
Указывает максимальное количество обновленных значений.
[out] phSummaryInfo
Указатель на расположение, из которого будет получен дескриптор сводной информации.
Возвращаемое значение
Функция MsiGetSummaryInformation возвращает следующие значения:
Замечания
Если база данных, указанная функцией msiGetSummaryInformation , не открыта, необходимо указать значение 0 для hDatabase и указать путь к базе данных в szDatabasePath. Если база данных открыта, необходимо задать szDatabasePath значение 0.
Если значение uiUpdateCount больше 0 используется для открытия существующего потока сведений сводки, необходимо вызвать MsiSummaryInfoPersist перед закрытием дескриптора phSummaryInfo. Не удается сделать это, потеряет существующую информацию о потоке.
Чтобы просмотреть сводную информацию о исправлении с помощью MsiGetSummaryInformation, задайте szDatabasePath путь к исправлению. Кроме того, можно создать дескриптор для исправления с помощью MsiOpenDatabase, а затем передать этот дескриптор в MsiGetSummaryInformation в качестве параметра hDatabase.
Обратите внимание, что рекомендуется использовать переменные типа PMSIHANDLE, так как установщик закрывает объекты PMSIHANDLE по мере их выхода из области, в то время как необходимо закрыть объекты MSIHANDLE, вызвав MsiCloseHandle. Дополнительные сведения см. в разделе Use PMSIHANDLE вместо HANDLE в разделе Рекомендации по установщику Windows.
Если функция завершается ошибкой, можно получить расширенные сведения об ошибке с помощью MsiGetLastErrorRecord.
Заметка
Заголовок msiquery.h определяет MsiGetSummaryInformation как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP |
| целевая платформа | Виндоус |
| заголовка | msiquery.h |
| библиотеки |
Msi.lib |
| DLL | Msi.dll |