UiCreatePatchPackageEx （Patchwiz.dll）

UiCreatePatchPackageEx 函式會採用套件建立檔案 （.pcp 檔案），併產生 Windows Installer 修補程式套件 （.msp 套件）。 呼叫 Msimsp.exe 是使用 Patchwiz.dll的建議方法。

UiCreatePatchPackageEx 函式可從 Patchwiz.dll 4.0 版開始使用，並擴充 UiCreatePatchPackage 函式的功能。

UINT UiCreatePatchPackageEx(
  LPCTSTR szPcpPath,              
  LPCTSTR szPatchPath,            
  LPCTSTR szLogPath,             
  HWND hwndStatus,                
  LPCTSTR szTempFolder,           
  BOOL fRemoveTempFolderContents,
  DWORD dwFlags,
  DWORD dwReserved    
);

參數

szPcpPath

此修補程式的修補程式建立屬性檔案 （.pcp 檔案） 的完整路徑。

szPatchPath

要建立之 Windows Installer 修補程式套件 （.msp 檔案） 的完整路徑。 此參數可能會 NULL 或空字串，但可能不會省略。 如果它是 NULL 或空字串，函式會使用 Properties Table （Patchwiz.dll）中的 PatchOutputPath 值。

szLogPath

要附加之文字記錄檔的完整路徑。 此參數可能會 NULL 或空字串，但可能不會省略。

hwndStatus

處理顯示狀態文字的視窗。 此參數可能會 NULL 或空字串，但可能不會省略。

szTempFolder

暫存盤的位置。 此參數可能會 NULL 或空字串，但可能不會省略。 用戶必須具有足夠的許可權，才能讀取和寫入此資料夾。 默認位置為 \~pcw_tmp.tmp\%TMP%。

fRemoveTempFolderContents

如果 TRUE，則如果存在，請移除暫存資料夾及其所有內容。 如果 FALSE，且資料夾存在，則函式會失敗。

dwFlags

此參數可以設定為下列值的其中一個或組合，以指定記錄或使用者介面選項。

旗	價值	意義
LOGNONE	0x00000000	不會將訊息寫入記錄檔。
LOGINFO	0x00000001	將參考訊息寫入記錄檔。
LOGWARN	0x00000002	將警告寫入記錄檔。
LOGERR	0x00000004	將錯誤訊息寫入記錄檔。
LOGPERFMESSAGES	0x00000008	將效能訊息寫入記錄。
UINONE	0x00000000f	不要顯示使用者介面。
UIALL	0x00000010	顯示使用者介面。

 

dwReserved

保留。 此參數必須設定為零。

傳回值

請參閱 UiCreatePatchPackage的傳回值中的表格。

言論

如需撰寫 .pcp 檔案並使用 UiCreatePatchPackage 產生 Windows Installer 修補程式套件的範例，請參閱 小型更新修補範例一節。

建立修補程式需要未壓縮的安裝映像，例如來自CD-ROM的系統管理映像或未壓縮的安裝映像。 UiCreatePatchPackage 不會為封包中的檔案產生二進位修補程式。