UiCreatePatchPackageEx (Patchwiz.dll)

La funzione UiCreatePatchPackageEx accetta un file di creazione del pacchetto (file con estensione pcp) e genera un pacchetto di patch di Windows Installer (pacchetto con estensione msp). La chiamata Msimsp.exe è il metodo consigliato per l'uso di Patchwiz.dll.

La funzione UiCreatePatchPackageEx è disponibile a partire da Patchwiz.dll versione 4.0 ed estende la funzionalità della funzione UiCreatePatchPackage .

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

Parametri

szPcpPath

Percorso completo del file delle proprietà di creazione delle patch (file con estensione pcp) per questa patch.

szPatchPath

Percorso completo del pacchetto patch di Windows Installer (file msp) da creare. Questo parametro può essere NULL o una stringa vuota, ma potrebbe non essere omesso. Se è NULL o una stringa vuota, la funzione usa il valore di PatchOutputPath nella tabella proprietà (Patchwiz.dll).

szLogPath

Percorso completo di un file di log di testo che verrà aggiunto. Questo parametro può essere NULL o una stringa vuota, ma potrebbe non essere omesso.

hwndStatus

Handle in una finestra che visualizza il testo di stato. Questo parametro può essere NULL o una stringa vuota, ma potrebbe non essere omesso.

szTempFolder

Percorso per i file temporanei. Questo parametro può essere NULL o una stringa vuota, ma potrebbe non essere omesso. L'utente deve disporre di privilegi sufficienti per leggere e scrivere in questa cartella. Il percorso predefinito è %TMP%\~pcw_tmp.tmp\.

fRemoveTempFolderContents

Se TRUE, rimuovere la cartella temporanea e tutto il relativo contenuto se presente. Se FALSE e la cartella è presente, la funzione ha esito negativo.

Dwflags

Questo parametro può essere impostato su una o una combinazione dei valori seguenti per specificare le opzioni di registrazione o interfaccia utente.

Flag	valore	Significato
LOGNONE	0x00000000	Non scrivere messaggi nel log.
LOGINFO	0x00000001	Scrivere messaggi informativi nel log.
LOGWARN	0x00000002	Scrivere avvisi nel log.
LOGERR	0x00000004	Scrivere messaggi di errore nel log.
LOGPERFMESSAGES	0x00000008	Scrivere messaggi di prestazioni nel log.
UINONE	0x00000000f	Non visualizzare l'interfaccia utente.
UIALL	0x00000010	Visualizzare l'interfaccia utente.

 

dwReserved

Riservato. Questo parametro deve essere impostato su zero.

Valori restituiti

Vedere la tabella in Valori restituiti per UiCreatePatchPackage.

Commenti

Per un esempio di creazione di un file con estensione pcp e con UiCreatePatchPackage per generare un pacchetto di patch di Windows Installer, vedere la sezione Un piccolo esempio di patch di aggiornamento.

La creazione di una patch richiede un'immagine di installazione non compressa, ad esempio un'immagine amministrativa o un'immagine di installazione non compressa da un CD-ROM. UiCreatePatchPackage non genera patch binarie per i file negli archivi.