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

Статья
08/24/2023

Функция MsiGetPatchFileList предоставляет список MSP-файлов, разделенных точкой с запятой, и извлекает список файлов, которые могут быть обновлены с помощью исправлений.

Синтаксис

UINT MsiGetPatchFileListA(
  [in]      LPCSTR    szProductCode,
  [in]      LPCSTR    szPatchPackages,
  [in, out] LPDWORD   pcFiles,
  [in, out] MSIHANDLE **pphFileRecords
);

Параметры

[in] szProductCode

Строковое значение, завершающееся null, содержащее код продукта (GUID), который является целевым объектом исправлений. Этот параметр не может иметь значение NULL.

[in] szPatchPackages

Строковое значение, завершающееся null, которое содержит список исправлений установщика Windows (MSP-файлы). Каждое исправление можно указать полным путем к пакету исправлений. Исправления в списке разделяются точкой с запятой. Необходимо указать хотя бы одно исправление.

[in, out] pcFiles

Указатель на расположение, которое получает количество файлов, которые будут обновлены в этой системе с помощью этого списка исправлений, указанного szPatchList. Это обязательный параметр.

[in, out] pphFileRecords

Указатель на расположение, которое получает указатель на массив записей. Первое поле (индекс 0) каждой записи содержит полный путь к файлу, который может быть обновлен при применении списка исправлений в szPatchList на этом компьютере. Это обязательный параметр.

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

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

Значение	Значение
ERROR_SUCCESS	Функция успешно завершена.
ERROR_INVALID_PARAMETER	В функцию передан недопустимый параметр.
ERROR_FUNCTION_FAILED	Сбой функции.

Эта функция выполняется в контексте вызывающего объекта. Поиск в коде продукта выполняется в порядке неуправляемого контекста пользователя, управляемого пользователем контекста и контекста компьютера.

Необходимо закрыть все объекты MSIHANDLE, возвращаемые этой функцией, вызвав функцию MsiCloseHandle .

В случае сбоя функции можно получить расширенные сведения об ошибке с помощью функции MsiGetLastErrorRecord .

Дополнительные сведения об использовании функции MsiGetPatchFileList см. в разделе Перечисление файлов, которые можно обновить.

Примечание

Заголовок msi.h определяет MsiGetPatchFileList в качестве псевдонима, который автоматически выбирает версию 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 4.5 в Windows Server 2003 и Windows XP. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в разделе Требования к установщику Windows Run-Time.
Целевая платформа	Windows
Header	msi.h
Библиотека	Msi.lib
DLL	Msi.dll

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

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