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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] szProductCode

Строковое значение, завершающее значение null, содержащее ProductCode (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	Не удалось выполнить функцию.

Замечания

Например, szPatchList может иметь значение : "c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp".

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

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

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

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

Заметка

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

См. также

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

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