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

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

  • Статья

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

Синтаксис

UINT MsiGetPatchInfoA(
  [in]      LPCSTR  szPatch,
  [in]      LPCSTR  szAttribute,
  [out]     LPSTR   lpValueBuf,
  [in, out] LPDWORD pcchValueBuf
);

Параметры

[in] szPatch

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

[in] szAttribute

Указывает извлекаемый атрибут.

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

[out] lpValueBuf

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

[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.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll

См. также раздел

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