Tabella TargetImages (Patchwiz.dll)

La tabella TargetImages contiene informazioni sulle immagini di destinazione del prodotto. Un pacchetto patch di Windows Installer aggiorna un'immagine di destinazione in un'immagine aggiornata.

In ogni database di creazione di patch (file con estensione pcp) è necessaria una tabella TargetImages contenente almeno un record. Questa tabella viene usata dalla funzione uiCreatePatchPackage.

La tabella TargetImages contiene le colonne seguenti.

Colonna	Digitare	Chiave	Nullable
Bersaglio	Testo	Y	N
MsiPath	Testo		N
SymbolPaths	Testo		Y
Aggiornato	Testo		N
Ordine	numero intero		N
ProductValidateFlags	Testo		Y
IgnoreMissingSrcFiles	numero intero		N

 

Colonne

destinazione

Identificatore per un'immagine di destinazione. Il pacchetto patch aggiorna l'immagine di destinazione specificata in questa colonna all'immagine aggiornata specificata nella colonna Aggiornato. Per ogni immagine aggiornata sono presenti una o più immagini di destinazione. L'immagine di destinazione deve essere un'immagine di configurazione completamente non compressa del prodotto, ad esempio un'immagine amministrativa o un'immagine di installazione non compressa in un CD-ROM. Si noti che la funzione UiCreatePatchPackageEx non genera patch binarie per i file nei file cab. Il valore in questo campo viene usato con il valore nel campo Aggiornato per generare i nomi delle trasformazioni aggiunte dal programma di installazione al pacchetto patch.

MsiPath

Questo campo specifica il percorso completo, incluso il nome file, nel percorso del file .msi per l'immagine di destinazione. Si tratta del percorso dei file di origine per l'immagine di destinazione.

Percorsi simbolo

Elenco delimitato da punto e virgola di cartelle in cui cercare i file di simboli che possono essere usati per ottimizzare la generazione della patch binaria. Si noti che le sottodirectory delle cartelle specificate in questo campo non vengono eseguite ricerche. Una patch binaria ottimizzata può essere più piccola. Microsoft Visual C++ deve essere installato nel computer che genera la patch e usato per creare i file di simboli. Questo campo è facoltativo e il programma di installazione crea una patch binaria anche se non vengono specificati file di simboli o se i file di simboli non sono disponibili per Patchwiz.dll.

aggiornato

Chiave esterna alla colonna Aggiornata della tabella UpgradedImages. La funzione uiCreatePatchPackageEx ignora qualsiasi immagine aggiornata a cui non fa riferimento almeno un record della tabella TargetImages.

ordine

Ordine relativo dell'immagine di destinazione. Poiché è possibile applicare patch a più destinazioni a un'immagine aggiornata, il campo Order fornisce un mezzo per sequenziare le trasformazioni nell'elenco delle trasformazioni patch. In genere, l'ordine è dal meno recente all'immagine più recente.

ProductValidateFlags

Il campo ProductValidateFlags viene usato per specificare il controllo del prodotto per evitare di applicare trasformazioni irrilevanti. Il valore immesso in questo campo deve essere un numero intero esadecimale a 8 cifre e uno dei valori validi per il parametro iValidation della funzione MsiCreateTransformSummaryInfo. Il valore predefinito è 0x00000922 che è uguale a MSITRANSFORM_VALIDATE_UPDATEVERSION + MSITRANSFORM_VALIDATE_NEWEQUALBASEVERSION + MSITRANSFORM_VALIDATE_UPGRADECODE + MSITRANSFORM_VALIDATE_PRODUCT.

IgnoreMissingSrcFiles

Se questo campo è impostato su un valore diverso da zero, i file mancanti nell'immagine di destinazione vengono ignorati dal programma di installazione e lasciati invariati durante l'applicazione di patch. In questo modo è possibile eseguire patch senza richiedere l'intera immagine; sono necessari solo i file modificati del prodotto e il file .msi. Ciò può ridurre il tempo necessario per generare la patch.

Nota

Non usare il valore IgnoreMissingSrcFiles con TrustMsi impostato su 1 nella tabella delle proprietà .

 

Osservazioni

Questa tabella accetta variabili di ambiente come percorsi che iniziano con la versione 4.0 di Patchwiz.dll.