Properties テーブル (Patchwiz.dll)

[アーティクル]
06/13/2023

Properties テーブルには、パッチパッケージのグローバル設定が含まれます。 Properties テーブルは、パッチ作成データベース (.pcp ファイル) で必須であり、UiCreatePatchPackageEx 関数によって使用されます。

Properties テーブルには次の列があります。

Column	種類	キー	Nullable
名前	text	Y	N
値	text		Y

[列]

Name: パッチ作成プロパティの名前。
Value: パッチ作成プロパティの値。

解説

次の表に、.pcp ファイルの Properties テーブルに入力できるパッチ作成プロパティの文字列を示します。

プロパティ	説明
AllowLaxValidationFlags	このプロパティが 1 に設定されている場合、TargetImages テーブルの ProductValidateFlags フィールドを検証できない場合でも、エントリがログに書き込まれ、エラーは返されません。このプロパティは、パッチ作成者が ProductValidateFlags フィールドの値を変更した場合にのみ設定する必要があります。このプロパティの既定値は 0 です。 Patchwiz.dll バージョン 4.0 以降で使用できます。
AllowProductCodeMismatches	UpgradedImages テーブルにリストされているアップグレードされたイメージと、TargetImages テーブルにリストされているターゲットイメージの間で ProductCode プロパティが異なってもよい場合は、True を表す "1" に設定します。製品コードが同じでなければならない場合は、False を表す "0" または空白に設定します。
AllowProductVersionMajorMismatches	アップグレードされたイメージとターゲットイメージの間で ProductVersion プロパティの最初のフィールド (メジャーバージョンフィールド) が異なってもよい場合は、True を表す "1" に設定します。メジャーバージョンが一致しなければならない場合は、False を表す "0" または空白に設定します。
ApiPatchingSymbolFlags	バイナリファイルパッチの作成時に使用するパッチシンボル使用フラグの組み合わせを表す 8 桁の 16 進整数。既定値は 0x00000000 です。使用可能な PATCH_SYMBOL_* フラグの全一覧については、Patchapi.h を参照してください。シンボルファイルの詳細については、用語集を参照してください。
DontRemoveTempFolderWhenFinished	パッチパッケージの作成後に、変換、バイトレベルのパッチ、および新しいファイル全体を含む一時フォルダーが削除されないようにする場合は、True を表す "1" に設定します。これは基本的に、パッチパッケージに埋め込まれる前の .msp ファイルの内容です。これは、パッチのデバッグに役立つ場合があります。一時フォルダーを削除する場合は、False を表す "0" または空白に設定します。
IncludeWholeFilesOnly	パッチパッケージの作成時に、バイナリファイルパッチを作成するのではなく、変更されるファイル全体を含める場合は、True を表す "1" に設定します。パッチファイルのサイズは大きくなりますが、API はより高速に実行されます。バイナリファイルパッチを作成する場合は、False を表す "0" または空白に設定します。
ListOfPatchGUIDsToReplace	区切り記号のない PatchGUID 識別子のリスト。これらのパッチのいずれかがユーザーのコンピューターにインストールされていて、Windows インストーラに登録されていることが判明した場合、それらのパッチは該当する製品から登録解除され、そのパッチ変換は、製品に関連付けられている変換のリストから削除されます。パッチの削除は、どのファイルにも影響せず、パッチの登録にのみ影響しますので注意してください。任意。
ListOfTargetProductCodes	このパッチを受け取ることができる製品の製品コードのリスト。これは、ProductCode プロパティ値のセミコロン区切りのリストです。リストがアスタリスクで始まる場合は、TargetImages テーブルにリストされているターゲットの.msi ファイルから製品コードのリストが生成されます。先頭のアスタリスクの後に製品コードが続く場合は、アスタリスクの代わりにそれらの製品コードがリストに追加されます。このプロパティが設定されていない場合、TargetImages テーブルにリストされているターゲットの .msi ファイルから製品コードのリストが生成されます。
MsiFileToUseToCreatePatchTables	Patch テーブルと PatchPackage テーブルのエクスポート元となるテンプレート .msi ファイルへの完全パス。省略可能です。Patchwiz.dll のバージョン 4.0 以降、Properties テーブルには、パスを示す環境変数を指定できます。環境変数には、%ENV_VAR% などの Windows 形式を使用します。 Formatted 列データ型は使用しないでください。
OptimizePatchSizeForLargeFiles	このプロパティは、値が存在し、"0" ではない場合に設定されます。このプロパティを設定すると、サイズが約 4 MB を超えるファイルのパッチを小さくすることができます。
PatchGUID	このパッチパッケージ (.msp ファイル) の GUID 識別子。すべてのパッチパッケージに、一意の PatchGUID 値が必要です。必須。
PatchOutputPath	生成するパッチパッケージファイルの完全パス (ファイル名を含む)。 UiCreatePatchPackageEx 関数によって szPatchPath が渡される場合、その渡された値が使用されます。 szPatchPath が null または空の文字列の場合、このプロパティは必須です。Patchwiz.dll のバージョン 4.0 以降、Properties テーブルには、パスを示す環境変数を指定できます。環境変数には、%ENV_VAR% などの Windows 形式を使用します。 Formatted 列データ型は使用しないでください。
PatchSourceList	ローカルにキャッシュされたコピーが使用できない場合に、パッチの .msp ファイルを検索するために使用するソース。この値は、製品に適用されるときに、パッチのソースリストに追加されます。任意。
MinimumRequiredMsiVersion	特定バージョンの Windows インストーラーを必須とするパッチを Patchwiz.dll で生成するには、このプロパティを設定します。このプロパティ値は、パッチパッケージの Word Count Summary プロパティに使用する値を決定するのに役立ちます。このプロパティの値は、インストールパッケージの Page Count Summary プロパティと同じ形式です。 .pcp ファイルで MinimumRequiredMsiVersion が 200 になっている場合、Patchwiz.dll は、パッチパッケージの Word Count Summary プロパティを 3 に設定します。これにより、バージョン 2.0 より前のバージョンの Windows インストーラーによってパッチが適用されなくなります。 .pcp ファイルで MinimumRequiredMsiVersion が 300 になっている場合、Patchwiz.dll は、パッチパッケージの Word Count Summary プロパティを 4 に設定します。これにより、バージョン 3.0 より前のバージョンの Windows インストーラーによってパッチが適用されなくなります。 .pcp ファイルで MinimumRequiredMsiVersion が 310 になっている場合、Patchwiz.dll は、パッチパッケージの Word Count Summary プロパティを 5 に設定します。これにより、バージョン 3.1 より前のバージョンの Windows インストーラーによってパッチが適用されなくなります。 .pcp ファイルで MinimumRequiredMsiVersion が 400 になっている場合、Patchwiz.dll は、パッチパッケージの Word Count Summary プロパティを 6 に設定します。これにより、バージョン 4.0 より前のバージョンの Windows インストーラーによってパッチが適用されなくなります。
PATCH_CACHE_ENABLED	PATCH_CACHE_DIR プロパティで指定したフォルダーにパッチ作成情報をキャッシュするには、このプロパティを 1 に設定します。更新イメージを更新した後に新しいパッチを再作成するとき、パッチキャッシュによってパッチの作成速度が向上します。このプロパティには、Windows インストーラー 2.0 以降の Patchwiz.dll が必要です。詳細については、「パッチ情報キャッシュ (Patchwiz.dll)」を参照してください。
PATCH_CACHE_DIR	このプロパティは、キャッシュされたパッチ情報を格納するフォルダーの名前に設定します。 Patchwiz.dll は、必要に応じてこのフォルダーを作成します。このフォルダーは、十分なディスク領域があるドライブに配置する必要があります。このプロパティは、PATCH_CACHE_ENABLED プロパティが 1 に設定されている場合にのみ使用されます。 Patchwiz.dll のバージョン 4.0 以降、Properties テーブルには、パスを示す環境変数を指定できます。環境変数には、%ENV_VAR% などの Windows 形式を使用します。 Formatted 列データ型は使用しないでください。
SEQUENCE_DATA_GENERATION_DISABLED	パッチシーケンス情報が自動生成されないようにするには、このプロパティを 1 に設定します。このプロパティが設定されていない場合、シーケンス情報が自動生成され、追加されます。
SEQUENCE_DATA_SUPERSEDENCE	このプロパティを 0 (ゼロ) または 1 に設定すると、その値が MsiPatchSequence テーブルのすべての行の Attributes フィールドに書き込まれます。
TrustMsi	.msi ファイルで提供されるファイルのバージョン情報、サイズ、およびハッシュ値を使用するには、Properties テーブルでこのプロパティを 1 に設定します。このプロパティが設定されている一方で、.msi ファイル内の情報が正しくない場合、作成されたパッチが正しく機能しない可能性があります。 MsiFiler.exe を使用して、ターゲット .msi ファイルとアップグレードされた .msi ファイルを更新する必要があります。このプロパティの既定値は 0 です。 Patchwiz.dll バージョン 4.0 以降で使用できます。