Properties テーブル (Patchwiz.dll)

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 以降で使用できます。