Properties Table (Patchwiz.dll)

發行項
06/13/2023

Properties Table 包含修補程式套件的全域設定。修補程式建立資料庫中需要 Properties Table (.pcp 檔案) ，而且由 UiCreatePatchPackageEx 函式使用。

[屬性資料表] 具有下列資料行。

資料行	類型	答案	Nullable
名稱	text	Y	N
值	text		Y

資料行

名字: 修補程式建立屬性的名稱。
價值: 修補程式建立屬性的值。

備註

下表識別可輸入 .pcp 檔案之 Properties Table 的修補程式建立屬性字串。

屬性	Description
AllowLaxValidationFlags	如果此屬性設定為 1，則會在記錄檔中寫入專案，而且如果無法驗證 TargetImages 資料表中的 ProductValidateFlags 欄位，則不會傳回錯誤。只有當修補程式作者已變更 ProductValidateFlags 欄位中的值時，才應該設定這個屬性。此屬性的預設值為 0。從 Patchwiz.dll 4.0 版開始提供。
AllowProductCodeMismatches	如果 ProductCode 屬性在 UpgradedImages 資料表中列出的升級映射和 TargetImages 資料表中列出的目標映射之間可能不同，則設定為 '1'。設定為 '0' 或空白表示如果產品代碼必須相同，則為 False。
AllowProductVersionMajorMismatches	如果 ProductVersion 屬性的主要版本) 欄位 (主要版本欄位 (，則設定為 '1' 表示 True。如果主要版本必須相符，請將設定為 '0' 或空白表示 False。
ApiPatchingSymbolFlags	8 位數十六進位整數，代表建立二進位檔案修補時要使用的修補程式符號使用旗標組合。預設值為 0x00000000。如需可能PATCH_SYMBOL_* 旗標的完整清單，請參閱 Patchapi.h。如需符號檔的詳細資訊，請參閱詞彙。
DontRemoveTempFolderWhenFinished	設定為 '1' 表示如果包含轉換的暫存資料夾、位元組層級修補程式，以及建立修補程式套件之後不會移除整個新檔案，則為 True。這基本上是 .msp 檔案的內容，再內嵌到修補程式套件中。這可能有助於偵錯修補程式。設定為 '0' 或空白表示如果要移除暫存資料夾，則為 False。
IncludeWholeFilesOnly	將設定為 '1' 表示如果在建立修補程式套件時，要完整包含變更的檔案，而不是建立二進位檔案修補程式，則為 True。修補程式檔案的大小將會變大，但 API 的執行速度會更快。設定為 '0' 或空白表示建立二進位檔案修補程式時為 False。
ListOfPatchGUIDsToReplace	沒有分隔符號的 PatchGUID 識別碼清單。如果找到任何修補程式安裝在使用者的電腦上並向 Windows Installer 註冊，則會從適當的產品取消註冊，並從與產品相關聯的轉換清單中移除其修補程式轉換。請注意，移除修補程式不會影響任何檔案，只影響修補程式的註冊。選擇性。
ListOfTargetProductCodes	可能收到此修補程式之產品的 [產品代碼 ] 清單。這是以分號分隔的 ProductCode 屬性值清單。如果清單以星號開頭，則會從 TargetImages 資料表中列出的目標.msi檔案產生產品代碼清單。如果有任何產品代碼遵循前置星號，它們會附加至取代星號的清單。如果未設定屬性，則會從 TargetImages 資料表中列出的目標.msi檔案產生產品代碼清單。
MsiFileToUseToCreatePatchTables	範本的完整路徑.msi要從中匯出 Patch Table 和 PatchPackage 資料表的檔案。 Optional.Properties Table 會接受從 4.0 版開始Patchwiz.dll路徑的環境變數。使用環境變數的 Windows 格式，例如 %ENV_VAR%。請勿使用格式化資料行資料類型。
OptimizePatchSizeForLargeFiles	當值存在且不是「0」時，就會設定這個屬性。設定此屬性時，大小超過 4 MB 的檔案修補程式可能會較小。
PatchGUID	這個修補程式套件 (.msp 檔案) 的 GUID 識別碼。每個修補程式套件都必須有唯一的 PatchGUID 值。必要。
PatchOutputPath	要產生之修補程式套件檔案的完整路徑，包括檔案名。如果 szPatchPath 是由 UiCreatePatchPackageEx 函式傳遞，則會使用傳遞的值。如果 szPatchPath 為 Null 或空字串，則需要這個屬性。Properties Table 接受從 Patchwiz.dll 4.0 版開始之路徑的環境變數。使用環境變數的 Windows 格式，例如 %ENV_VAR%。請勿使用格式化資料行資料類型。
PatchSourceList	在本機快取複本無法使用時，用來尋找修補程式的 .msp 檔案的來源。當修補程式套用至產品時，這個值會新增至修補程式的來源清單。選擇性。
MinimumRequiredMsiVersion	將此屬性設定為強制Patchwiz.dll產生需要特定 Windows Installer 版本的修補程式。這個屬性值有助於判斷修補套件Word Count Summary Property 要使用的值。這個屬性的值與安裝套件的 Page Count Summary 屬性的格式相同。如果 .pcp 檔案的 MinimumRequiredMsiVersion 等於 200，Patchwiz.dll會將修補程式套件的Word Count Summary屬性設定為 3。這可防止 Windows Installer 版本早于 2.0 版的修補程式套用。如果 .pcp 檔案的 MinimumRequiredMsiVersion 等於 300，Patchwiz.dll會將修補程式套件的Word Count Summary屬性設定為 4。這可防止 Windows Installer 版本早于 3.0 版的修補程式套用。如果 .pcp 檔案的 MinimumRequiredMsiVersion 等於 310，Patchwiz.dll將修補程式套件的Word Count Summary屬性設定為 5。這可防止 Windows Installer 在 3.1 版之前套用修補程式。如果 .pcp 檔案的 MinimumRequiredMsiVersion 等於 400，Patchwiz.dll將修補程式套件的Word Count Summary屬性設定為 6。這可防止 Windows Installer 在 4.0 版之前套用修補程式。
PATCH_CACHE_ENABLED	將此屬性設定為 1，以快取 PATCH_CACHE_DIR 屬性所指定資料夾中的修補程式建立資訊。更新更新映射之後重新建立新的修補程式時，修補程式快取會增加修補程式建立的速度。此屬性需要在 Windows Installer 2.0 或更新版本中Patchwiz.dll。如需詳細資訊，請參閱修補資訊快取 (Patchwiz.dll) 。
PATCH_CACHE_DIR	將此屬性設定為儲存快取修補程式資訊的資料夾名稱。 Patchwiz.dll視需要建立此資料夾。資料夾應該位於具有足夠磁碟空間的磁片磁碟機上。只有當 PATCH_CACHE_ENABLED 屬性設定為 1 時，才會使用這個屬性。 Properties Table 會接受從 4.0 版開始Patchwiz.dll路徑的環境變數。使用環境變數的 Windows 格式，例如 %ENV_VAR%。請勿使用格式化資料行資料類型。
SEQUENCE_DATA_GENERATION_DISABLED	將此屬性設定為 1 (一個) ，以防止自動產生修補程式排序資訊。如果此屬性不存在，則會自動產生並新增排序資訊。
SEQUENCE_DATA_SUPERSEDENCE	將此屬性設定為 0 (零) 或 1 (一個) ，以在 MsiPatchSequence 資料表中所有資料列的 Attributes 欄位中寫入該值。
TrustMsi	將 [屬性資料表] 中的這個屬性設定為 1，以使用.msi檔案中提供的檔案版本資訊、大小和雜湊值。如果已設定此屬性，但.msi檔案中的資訊不正確，則建立的修補程式可能無法正常運作。您應該使用 MsiFiler.exe來更新目標和升級.msi檔案。此屬性的預設值為 0。從 Patchwiz.dll 4.0 版開始提供。