UiCreatePatchPackage (Patchwiz.dll)

UiCreatePatchPackage 関数は、パッケージ作成ファイル (.pcp ファイル) を受け取り、Windows インストーラー パッチ パッケージ (.msp パッケージ) を生成します。 Patchwiz.dll を使用する場合は、Msimsp.exe を呼び出しす方法が推奨されます。 UiCreatePatchPackageEx 関数は、Patchwiz.dll のバージョン 4.0 で使用でき、UiCreatePatchPackage 関数の機能を拡張します。

UINT UiCreatePatchPackage(
  LPCTSTR szPcpPath,              
  LPCTSTR szPatchPath,            
  LPCTSTR szLogPath,             
  HWND hwndStatus,                
  LPCTSTR szTempFolder,           
  Bool fRemoveTempFolderContents  
);

パラメーター

szPcpPath

このパッチのパッチ作成プロパティ ファイル (.pcp ファイル) への完全なパス。

szPatchPath

作成する Windows インストーラー パッチ パッケージ (.msp ファイル) への完全なパス。 このパラメーターは NULL または空の文字列にできますが、省略はできません。 NULL または空の文字列の場合、この関数は Properties テーブル (Patchwiz.dll) の PatchOutputPath の値を使用します。

szLogPath

追加されるテキスト ログ ファイルへの完全なパス。 このパラメーターは NULL または空の文字列にできますが、省略はできません。

hwndStatus

状態テキストを表示するウィンドウへのハンドル。 このパラメーターは NULL または空の文字列にできますが、省略はできません。

szTempFolder

一時ファイルの場所。 このパラメーターは NULL または空の文字列にできますが、省略はできません。 既定の場所は %TMP%\~pcw_tmp.tmp\ です。

fRemoveTempFolderContents

TRUE の場合、一時フォルダーとそのすべての内容 (存在する場合) を削除します。 FALSE で、フォルダーが存在する場合、この関数は失敗します。

戻り値

「UiCreatePatchPackage の戻り値」の表を参照してください。

解説

.pcp ファイルを作成し、UiCreatePatchPackage を使用して Windows インストーラー パッチ パッケージを生成する例については、「小規模な更新プログラムのパッチ適用の例」のセクションを参照してください。

パッチを作成するには、管理イメージや CD-ROM からの非圧縮セットアップ イメージなどの非圧縮セットアップ イメージが必要です。 UiCreatePatchPackage では、キャビネット内のファイルのバイナリ パッチは生成されません。