Функция MsiGetPatchInfoA (msi.h)
Функция MsiGetPatchInfo возвращает сведения о исправлении.
Синтаксис
UINT MsiGetPatchInfoA(
[in] LPCSTR szPatch,
[in] LPCSTR szAttribute,
[out] LPSTR lpValueBuf,
[in, out] LPDWORD pcchValueBuf
);
Параметры
[in] szPatch
Указывает код исправления для пакета исправлений.
[in] szAttribute
Указывает извлекаемый атрибут.
attribute | Значение |
---|---|
|
Локальный кэшированный пакет. |
[out] lpValueBuf
Указатель на буфер, который получает значение свойства. Этот параметр может быть нулевым.
[in, out] pcchValueBuf
Указатель на переменную, указывающую размер (в символах) буфера, на который указывает параметр lpValueBuf . На входных данных это полный размер буфера, включая пробел для завершающего символа NULL. Если переданный буфер слишком мал, возвращаемое число не включает завершающий символ NULL.
Если lpValueBuf имеет значение NULL, pcchValueBuf может иметь значение NULL.
Возвращаемое значение
Функция MsiGetPatchInfo возвращает следующие значения.
Значение | Значение |
---|---|
|
Данные конфигурации повреждены. |
|
В функцию передан недопустимый параметр. |
|
Буфер слишком мал для хранения запрошенных данных. |
|
Функция успешно завершена. |
|
Пакет исправлений не установлен. |
|
Свойство нераспознано. |
Комментарии
При возврате функции MsiGetPatchInfo параметр pcchValueBuf содержит длину строки класса, хранящейся в буфере. Возвращаемое число не включает завершающий символ NULL.
Если буфер слишком мал для хранения запрошенных данных, MsiGetPatchInfo возвращает ERROR_MORE_DATA, а pcchValueBuf содержит количество символов, скопированных в lpValueBuf, без подсчета символа NULL.
Примечание
Заголовок msi.h определяет MsiGetPatchInfo в качестве псевдонима, который автоматически выбирает версию 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. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в разделе Требования к установщику Windows Run-Time. |
Целевая платформа | Windows |
Header | msi.h |
Библиотека | Msi.lib |
DLL | Msi.dll |
См. также раздел
Не поддерживается в установщике Windows 2.0 и более ранних версий