UiCreatePatchPackageEx (Patchwiz.dll)

Funkcja UiCreatePatchPackageEx przyjmuje plik tworzenia pakietu (plik pcp) i generuje pakiet poprawek Instalatora Windows (pakiet msp). Wywoływanie Msimsp.exe jest zalecaną metodą używania Patchwiz.dll.

Funkcja UiCreatePatchPackageEx jest dostępna od Patchwiz.dll w wersji 4.0 i rozszerza funkcjonalność funkcji UiCreatePatchPackage.

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

Parametry

szPcpPath

Pełna ścieżka do pliku właściwości tworzenia poprawek (plik pcp) dla tej poprawki.

szPatchPath

Pełna ścieżka do pakietu poprawek Instalatora Windows (plik msp), który ma zostać utworzony. Ten parametr może być null lub pusty ciąg, ale może nie zostać pominięty. Jeśli jest to null lub pusty ciąg, funkcja używa wartości PatchOutputPath w tabeli właściwości (Patchwiz.dll).

szLogPath

Pełna ścieżka do pliku dziennika tekstowego, który zostanie dołączony. Ten parametr może być null lub pusty ciąg, ale może nie zostać pominięty.

hwndStatus

Dojmij do okna, w ramach którego jest wyświetlany tekst stanu. Ten parametr może być null lub pusty ciąg, ale może nie zostać pominięty.

szTempFolder

Lokalizacja plików tymczasowych. Ten parametr może być null lub pusty ciąg, ale może nie zostać pominięty. Użytkownik musi mieć wystarczające uprawnienia do odczytu i zapisu w tym folderze. Lokalizacja domyślna to %TMP%\~pcw_tmp.tmp\.

fRemoveTempFolderContents

Jeśli true, usuń folder tymczasowy i całą jego zawartość, jeśli jest obecna. Jeśli false, i folder jest obecny, funkcja zakończy się niepowodzeniem.

dwFlags

Ten parametr można ustawić na jedną lub kombinację następujących wartości, aby określić opcje rejestrowania lub interfejsu użytkownika.

Flaga	Wartość	Znaczenie
LOGNONE	0x00000000	Nie zapisuj żadnych komunikatów w dzienniku.
LOGINFO	0x00000001	Zapisywanie komunikatów informacyjnych w dzienniku.
LOGWARN	0x00000002	Zapisz ostrzeżenia w dzienniku.
LOGERR	0x00000004	Zapisywanie komunikatów o błędach w dzienniku.
LOGPERFMESSAGES	0x00000008	Zapisywanie komunikatów o wydajności w dzienniku.
UINONE	0x00000000f	Nie wyświetlaj interfejsu użytkownika.
UIALL	0x00000010	Wyświetl interfejs użytkownika.

 

dwReserved

Zastrzeżony. Ten parametr musi być ustawiony na zero.

Zwracane wartości

Zobacz tabelę w wartości zwracanych dla elementu UiCreatePatchPackage.

Uwagi

Aby zapoznać się z przykładem tworzenia pliku pcp i używania UiCreatePatchPackage w celu wygenerowania pakietu poprawek Instalatora Windows, zobacz sekcję Przykład małej poprawki aktualizacji.

Utworzenie poprawki wymaga nieskompresowanego obrazu konfiguracji, takiego jak obraz administracyjny lub nieskompresowany obraz konfiguracji z dysku CD-ROM. UiCreatePatchPackage nie generuje poprawek binarnych dla plików w szafkach.