Таблица свойств (Patchwiz.dll)

Статья
06/13/2023

Таблица свойств содержит глобальные параметры для пакета исправлений. Таблица свойств требуется в базе данных создания исправлений (PCP-файле) и используется функцией UiCreatePatchPackageEx .

Таблица свойств содержит следующие столбцы.

Столбец	Type	Ключ	Допускает значения NULL
Имя	текст	Да	N
Значение	текст		Да

Столбцы

Имя: Имя свойства создания исправления.
Значение: Значение свойства создания исправления.

Комментарии

В следующей таблице указаны строки свойств создания исправлений, которые можно ввести в таблицу свойств PCP-файла.

Свойство	Описание
AllowLaxValidationFlags	Если для этого свойства задано значение 1, запись записывается в журнал, и если не удается проверить поле ProductValidateFlags в таблице TargetImages , ошибка не возвращается. Это свойство следует задавать только в том случае, если автор исправления изменил значение в поле ProductValidateFlags. Значение по умолчанию для этого свойства — 0. Доступно начиная с Patchwiz.dll версии 4.0.
AllowProductCodeMismatches	Задайте значение "1" для параметра True, если свойство ProductCode может отличаться между обновленными образами, перечисленными в таблице UpgradedImages , и целевыми изображениями, перечисленными в таблице TargetImages. Задайте значение "0" или пустое значение , чтобы означать False, если коды продуктов должны быть одинаковыми.
AllowProductVersionMajorMismatches	Задайте значение "1", чтобы иметь значение True, если первое поле (основное поле версии) свойства ProductVersion может отличаться в обновленных и целевых образах. Задайте значение "0" или пустое значение , чтобы означать False, если основные версии должны совпадать.
ApiPatchingSymbolFlags	8-значное шестнадцатеричное целое число, представляющее сочетание флагов использования символов исправлений, используемых при создании исправления двоичного файла. Значение по умолчанию — 0x00000000. Полный список возможных флагов PATCH_SYMBOL_* см. в разделе Patchapi.h. Дополнительные сведения о файлах символов см. в глоссарии.
DontRemoveTempFolderWhenFinished	Задайте значение "1", чтобы иметь значение True, если временная папка, содержащая преобразования, исправления на уровне байтов и все новые файлы, не удаляются после создания пакета исправлений. Это, по сути, содержимое MSP-файла перед внедрением в пакет исправлений. Это может быть полезно для отладки исправлений. Задайте значение "0" или пустое значение , чтобы означать False, если временная папка должна быть удалена.
IncludeWholeFilesOnly	Задайте значение "1", чтобы иметь значение True, если изменяемые файлы должны быть включены в их полное состояние при создании пакета исправлений, а не при создании исправления двоичного файла. Размер файлов исправлений будет больше, но API выполняется быстрее. При создании исправления двоичного файла задайте значение "0" или пустое значение , чтобы иметь значение False.
ListOfPatchGUIDsToReplace	Список идентификаторов PatchGUID без разделителя. Если какое-либо из этих исправлений установлено на компьютере пользователя и зарегистрировано в установщике Windows, они отменяются в соответствующем продукте, а их преобразования исправлений удаляются из списка преобразований, связанных с продуктом. Обратите внимание, что удаление исправления не влияет ни на один из файлов, а только на регистрацию исправления. Необязательный элемент.
ListOfTargetProductCodes	Список кодов продуктов для продуктов, которые могут получить это исправление. Это разделенный точкой с запятой список значений свойств ProductCode . Если список начинается звездочкой, список кодов продуктов создается из .msi файлов целевых объектов, перечисленных в таблице TargetImages. Если какие-либо коды продуктов следуют за звездочкой в начале, они добавляются в список, заменяющий звездочку. Если свойство не задано, список кодов продуктов создается из .msi файлов целевых объектов, перечисленных в таблице TargetImages.
MsiFileToUseToCreatePatchTables	Полный путь к шаблону .msi файл, из которого необходимо экспортировать таблицу исправлений и таблицу PatchPackage. Необязательный.Таблица свойств принимает переменные среды для путей, начиная с версии 4.0 Patchwiz.dll. Используйте формат Windows для переменной среды, например %ENV_VAR%. Не используйте тип данных Форматированный столбец.
OptimizePatchSizeForLargeFiles	Это свойство задается, если значение существует и не равно "0". Если это свойство задано, исправления для файлов размером более 4 МБ могут быть уменьшены.
PatchGUID	Идентификатор GUID для этого пакета исправлений (MSP-файл). Каждый пакет исправлений должен иметь уникальное значение PatchGUID. Обязательный.
PatchOutputPath	Полный путь к создаваемому файлу пакета исправлений, включая имя файла. Если функция szPatchPath передается функцией UiCreatePatchPackageEx , используется переданное значение. Это свойство является обязательным, если szPatchPath имеет значение NULL или является пустой строкой. Таблица свойств принимает переменные среды для путей, начиная с версии 4.0 Patchwiz.dll. Используйте формат Windows для переменной среды, например %ENV_VAR%. Не используйте тип данных Форматированный столбец.
PatchSourceList	Источник, используемый для поиска MSP-файла для исправления в случае недоступности локально кэшируемой копии. Это значение добавляется в исходный список исправления при его применении к продукту. Необязательный элемент.
MinimumRequiredMsiVersion	Задайте это свойство, чтобы принудительно Patchwiz.dll создать исправление, требующее определенной версии установщика Windows. Это значение свойства помогает определить, какое значение следует использовать для сводного свойства Word Count пакета исправлений. Значение этого свойства имеет ту же форму, что и сводное свойство "Число страниц " пакета установки. Если PCP-файл имеет значение MinimumRequiredMsiVersion, равное 200, Patchwiz.dll присваивает свойству Word Count Summary пакета исправлений значение 3. Это предотвращает применение исправления установщиком Windows версии, предшествующей версии 2.0. Если PCP-файл имеет значение MinimumRequiredMsiVersion, равное 300, Patchwiz.dll задает для свойства Word Count Summary пакета исправлений значение 4. Это предотвращает применение исправления установщиком Windows версий, предшествующих версии 3.0. Если PCP-файл имеет значение MinimumRequiredMsiVersion, равное 310, Patchwiz.dll устанавливает для свойства сводки Word Count пакета исправлений значение 5. Это предотвращает применение исправления установщиком Windows до версии 3.1. Если PCP-файл имеет значение MinimumRequiredMsiVersion, равное 400, Patchwiz.dll присваивает свойству Word Count Summary пакета исправлений значение 6. Это предотвращает применение исправления установщиком Windows до версии 4.0.
PATCH_CACHE_ENABLED	Присвойте этому свойству значение 1, чтобы кэшировать сведения о создании исправлений в папке, указанной свойством PATCH_CACHE_DIR. Кэширование исправлений увеличивает скорость создания исправления при создании нового исправления после обновления образа обновления. Для этого свойства требуется Patchwiz.dll в установщике Windows 2.0 или более поздней версии. Дополнительные сведения см. в разделе Кэширование сведений о исправлениях (Patchwiz.dll).
PATCH_CACHE_DIR	Присвойте этому свойству имя папки, в которую хранятся кэшированные сведения об исправлениях. Patchwiz.dll при необходимости создает эту папку. Папка должна находиться на диске с достаточным пространством. Это свойство используется только в том случае, если для свойства PATCH_CACHE_ENABLED задано значение 1. Таблица свойств принимает переменные среды для путей, начиная с версии 4.0 Patchwiz.dll. Используйте формат Windows для переменной среды, например %ENV_VAR%. Не используйте тип данных Форматированный столбец.
SEQUENCE_DATA_GENERATION_DISABLED	Присвойте этому свойству значение 1 (один), чтобы предотвратить автоматическое создание сведений о последовательности исправлений. Если это свойство отсутствует, сведения о последовательности создаются и добавляются автоматически.
SEQUENCE_DATA_SUPERSEDENCE	Присвойте этому свойству значение 0 (ноль) или 1 (один), чтобы записать это значение в поле Атрибуты всех строк таблицы MsiPatchSequence.
TrustMsi	Присвойте этому свойству значение 1 в таблице свойств, чтобы использовать сведения о версии файла, размере и хэш-значениях, указанных в файле .msi. Если это свойство задано, но сведения в файле .msi неверны, созданное исправление может работать неправильно. Следует обновить целевые и обновленные файлы .msi с помощью MsiFiler.exe. Значение по умолчанию для этого свойства — 0. Доступно начиная с Patchwiz.dll версии 4.0.