Функция MsiGetSummaryInformationW (msiquery.h)
Функция MsiGetSummaryInformation получает дескриптор потока _SummaryInformation для базы данных установщика. Эта функция возвращает дескриптор, который должен быть закрыт с помощью MsiCloseHandle.
Синтаксис
UINT MsiGetSummaryInformationW(
[in] MSIHANDLE hDatabase,
[in] LPCWSTR szDatabasePath,
[in] UINT uiUpdateCount,
[out] MSIHANDLE *phSummaryInfo
);
Параметры
[in] hDatabase
Дескриптор базы данных.
[in] szDatabasePath
Указывает путь к базе данных.
[in] uiUpdateCount
Задает максимальное число обновленных значений.
[out] phSummaryInfo
Указатель на расположение, из которого будет получен дескриптор сводной информации.
Возвращаемое значение
Функция MsiGetSummaryInformation возвращает следующие значения:
Комментарии
Если база данных, указанная функцией MsiGetSummaryInformation , не открыта, необходимо указать 0 для hDatabase и указать путь к базе данных в szDatabasePath. Если база данных открыта, необходимо задать для szDatabasePath значение 0.
Если для открытия существующего потока сводной информации используется значение uiUpdateCount больше 0, перед закрытием дескриптора phSummaryInfo Следует вызвать MsiSummaryInfoPersist. Если это не сделать, существующие сведения о потоке будут потеряны.
Чтобы просмотреть сводные сведения об исправлении с помощью MsiGetSummaryInformation, задайте для szDatabasePath путь к исправлению. Кроме того, можно создать дескриптор исправления с помощью MsiOpenDatabase , а затем передать этот дескриптор в MsiGetSummaryInformation в качестве параметра hDatabase .
Обратите внимание, что рекомендуется использовать переменные типа PMSIHANDLE, так как установщик закрывает объекты PMSIHANDLE по мере их выхода из область, тогда как необходимо закрывать объекты MSIHANDLE путем вызова MsiCloseHandle. Дополнительные сведения см. в разделе Использование PMSIHANDLE вместо HANDLE статьи Рекомендации по установщику Windows.
В случае сбоя функции можно получить расширенные сведения об ошибке с помощью MsiGetLastErrorRecord.
Примечание
Заголовок msiquery.h определяет MsiGetSummaryInformation в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Установщик 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 |
| Целевая платформа | Windows |
| Header | msiquery.h |
| Библиотека | Msi.lib |
| DLL | Msi.dll |