UiCreatePatchPackageEx (Patchwiz.dll)

De functie UiCreatePatchPackageEx maakt een pakketbestand (.pcp-bestand) en genereert een Windows Installer-patchpakket (.msp-pakket). Het aanroepen van Msimsp.exe is de aanbevolen methode voor het gebruik van Patchwiz.dll.

De functie UiCreatePatchPackageEx is beschikbaar vanaf Patchwiz.dll versie 4.0 en breidt de functionaliteit van de UiCreatePatchPackage-functie uit.

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

Parameters

szPcpPath-

Volledig pad naar het eigenschappenbestand voor het maken van patches (.pcp-bestand) voor deze patch.

szPatchPath-

Volledig pad naar het Windows Installer-patchpakket (.msp-bestand) dat moet worden gemaakt. Deze parameter kan worden NULL- of een lege tekenreeks, maar kan niet worden weggelaten. Als deze NULL- of een lege tekenreeks is, gebruikt de functie de waarde van PatchOutputPath in de eigenschappentabel (Patchwiz.dll).

szLogPath-

Volledig pad naar een tekstbestand dat wordt toegevoegd. Deze parameter kan worden NULL- of een lege tekenreeks, maar kan niet worden weggelaten.

hwndStatus-

Greep naar een venster waarin de statustekst wordt weergegeven. Deze parameter kan worden NULL- of een lege tekenreeks, maar kan niet worden weggelaten.

szTempFolder-

Locatie voor tijdelijke bestanden. Deze parameter kan worden NULL- of een lege tekenreeks, maar kan niet worden weggelaten. De gebruiker moet voldoende bevoegdheden hebben om naar deze map te kunnen lezen en schrijven. De standaardlocatie is %TMP%\~pcw_tmp.tmp\.

fRemoveTempFolderContents

Als TRUE, verwijdert u de tijdelijke map en alle inhoud ervan indien aanwezig. Als ONWAARen de map aanwezig is, mislukt de functie.

dwFlags-

Deze parameter kan worden ingesteld op een of een combinatie van de volgende waarden om opties voor logboekregistratie of gebruikersinterface op te geven.

Vlag	Waarde	Betekenis
LOGNONE	0x00000000	Schrijf geen berichten naar het logboek.
LOGINFO	0x00000001	Schrijf informatieve berichten naar het logboek.
LOGWARN	0x00000002	Schrijf waarschuwingen naar het logboek.
LOGERR	0x00000004	Schrijf foutberichten naar het logboek.
LOGPERFMESSAGES	0x00000008	Schrijf prestatieberichten naar het logboek.
UINONE	0x00000000f	Geef de gebruikersinterface niet weer.
UIALL	0x00000010	De gebruikersinterface weergeven.

 

dwReserved-

Gereserveerd. Deze parameter moet worden ingesteld op nul.

Retourwaarden

Zie de tabel in Return Values for UiCreatePatchPackage.

Opmerkingen

Zie de sectie A Small Update Patching Examplevoor een voorbeeld van het ontwerpen van een PCP-bestand en het gebruik van UiCreatePatchPackage om een Windows Installer-patchpakket te genereren.

Voor het maken van een patch is een niet-gecomprimeerde installatiekopieën vereist, zoals een installatiekopieën met beheerdersrechten of een niet-gecomprimeerde installatiekopieën van een cd-rom. UiCreatePatchPackage- genereert geen binaire patches voor bestanden in kasten.