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 或空字串，但不能省略。 使用者必須具有足夠的許可權，才能讀取和寫入此資料夾。 預設位置為 %TMP%\~pcw_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 不會為封包中的檔案產生二進位修補程式。