Функция MsiGetPatchInfoW (msi.h)

Статья
11/20/2024

Функция MsiGetPatchInfo возвращает сведения о исправлении.

Синтаксис

UINT MsiGetPatchInfoW(
  [in]      LPCWSTR szPatch,
  [in]      LPCWSTR szAttribute,
  [out]     LPWSTR  lpValueBuf,
  [in, out] LPDWORD pcchValueBuf
);

Параметры

[in] szPatch

Указывает код исправления для пакета исправлений.

[in] szAttribute

Указывает атрибут, который требуется извлечь.

Атрибут	Значение
INSTALLPROPERTY_LOCALPACKAGE	Локальный кэшированный пакет.

[out] lpValueBuf

Указатель на буфер, получающий значение свойства. Этот параметр может иметь значение NULL.

[in, out] pcchValueBuf

Указатель на переменную, указывающую размер буфера в символах, на который указывает параметр lpValueBuf. В входных данных это полный размер буфера, включая пробел для конца символа NULL. Если буфер, переданный слишком маленьким, возвращаемое число не включает завершающий символ NULL.

Если lpValueBuf имеет значение NULL, pcchValueBuf может иметь значение NULL.

Возвращаемое значение

Функция msiGetPatchInfo возвращает следующие значения.

Ценность	Значение
ERROR_BAD_CONFIGURATION	Данные конфигурации повреждены.
ERROR_INVALID_PARAMETER	Недопустимый параметр был передан функции.
ERROR_MORE_DATA	Буфер слишком мал для хранения запрошенных данных.
ERROR_SUCCESS	Функция успешно завершена.
ERROR_UNKNOWN_PRODUCT	Пакет исправлений не установлен.
ERROR_UNKNOWN_PROPERTY	Свойство не распознается.

Замечания

Когда функция 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".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

не поддерживается в установщике Windows 2.0 и более ранних

Поделиться через