Tabella proprietà (Patchwiz.dll)
La tabella proprietà contiene le impostazioni globali per il pacchetto patch. La tabella delle proprietà è necessaria nel database di creazione della patch (file con estensione pcp) e viene usata dalla funzione UiCreatePatchPackageEx.
La tabella proprietà contiene le colonne seguenti.
Colonna | Digitare | Chiave | Nullable |
---|---|---|---|
Nome | Testo | Y | N |
Valore | Testo | Y |
Colonne
-
nome
-
Nome di una proprietà di creazione di patch.
-
valore
-
Valore della proprietà di creazione della patch.
Osservazioni
La tabella seguente identifica le stringhe di proprietà di creazione patch che possono essere immesse nella tabella proprietà del file con estensione pcp.
Proprietà | Descrizione |
---|---|
AllowLaxValidationFlags | Se questa proprietà è impostata su 1, nel log viene scritta una voce e non viene restituito alcun errore se il campo ProductValidateFlags nella tabella TargetImages non può essere convalidato. Questa proprietà deve essere impostata solo quando l'autore della patch ha modificato il valore nel campo ProductValidateFlags. Il valore predefinito per questa proprietà è 0. Disponibile a partire da Patchwiz.dll versione 4.0. |
AllowProductCodeMismatches | Impostare su "1" per True se la proprietàProductCode può differire tra le immagini aggiornate elencate nella Tabella UpgradedImages e le immagini di destinazione elencate nella tabella TargetImages. Impostare su "0" o vuoto per indicare False se i codici di prodotto devono essere uguali. |
AllowProductVersionMajorMismatches | Impostare su "1" per indicare True se il primo campo (il campo della versione principale) del ProductVersion Proprietà può differire tra immagini aggiornate e immagini di destinazione. Impostare su '0' o vuoto per indicare False se le versioni principali devono corrispondere. |
ApiPatchingSymbolFlags | Intero esadecimale a 8 cifre che rappresenta la combinazione di flag di utilizzo dei simboli di patch da usare durante la creazione di una patch di file binario. Il valore predefinito è 0x00000000. Per l'elenco completo dei possibili flag PATCH_SYMBOL_*, vedere Patchapi.h. Per altre informazioni sui file di simboli, vedere il glossario. |
DontRemoveTempFolderWhenFinished | Impostare su "1" per indicare True se la cartella temporanea contenente le trasformazioni, le patch a livello di byte e l'intero nuovo file non vengono rimossi dopo la creazione del pacchetto patch. Si tratta essenzialmente del contenuto del file msp prima di essere incorporato nel pacchetto patch. Può essere utile per il debug delle patch. Impostare su '0' o vuoto per indicare False se la cartella temporanea deve essere rimossa. |
IncludeWholeFilesOnly | Impostare su "1" per indicare True se i file modificati devono essere inclusi nell'intero pacchetto quando si crea il pacchetto patch invece di creare una patch di file binario. I file patch saranno di dimensioni maggiori, ma l'API viene eseguita più velocemente. Impostare su "0" o vuoto per indicare False se si crea una patch di file binario. |
ListOfPatchGUIDsToReplace | Elenco di identificatori PatchGUID senza delimitatori. Se una di queste patch viene trovata per essere installata nel computer dell'utente e registrata con Windows Installer, viene annullata la registrazione dal prodotto appropriato e le trasformazioni patch vengono rimosse dall'elenco di trasformazioni associate al prodotto. Si noti che la rimozione di una patch non influisce su alcun file, ma solo sulla registrazione della patch. Opzionale. |
ListOfTargetProductCodes | Elenco dei codici prodotto per i prodotti che potrebbero ricevere questa patch. Si tratta di un elenco delimitato da punto e virgola dei valori ProductCode Property. Se l'elenco inizia con un asterisco, l'elenco dei codici prodotto viene generato dai file .msi delle destinazioni elencate nella Tabella TargetImages. Se i codici prodotto seguono un asterisco iniziale, vengono aggiunti all'elenco che sostituisce l'asterisco. Se la proprietà non è impostata, viene generato un elenco di codici prodotto dai file .msi delle destinazioni elencate nella Tabella TargetImages. |
MsiFileToUseToCreatePatchTables | Percorso completo di un file di .msi modello da cui esportare tabella patch e tabella PatchPackage. Facoltativa.La tabella delle proprietà accetta variabili di ambiente per i percorsi che iniziano con la versione 4.0 di Patchwiz.dll. Usare il formato Windows per la variabile di ambiente, ad esempio %ENV_VAR%. Non utilizzare il tipo di dati colonna formattato. |
OptimizePatchSizeForLargeFiles | Questa proprietà viene impostata quando il valore esiste e non è "0". Quando questa proprietà è impostata, le patch per i file di dimensioni superiori a 4 MB possono essere ridotte. |
PatchGUID | Identificatore GUID per questo pacchetto patch (file msp). Ogni pacchetto patch deve avere un valore PatchGUID univoco. Obbligatorio. |
PatchOutputPath | Percorso completo, incluso il nome file, del file del pacchetto patch che deve essere generato. Se szPatchPath viene passato dalla funzione uiCreatePatchPackageEx, viene usato il valore passato. Questa proprietà è obbligatoria se szPatchPath è null o una stringa vuota. La tabella proprietà accetta variabili di ambiente per i percorsi che iniziano con la versione 4.0 di Patchwiz.dll. Usare il formato Windows per la variabile di ambiente, ad esempio %ENV_VAR%. Non utilizzare il tipo di dati colonna formattato. |
PatchSourceList | Origine usata per individuare il file msp per la patch nel caso in cui la copia memorizzata nella cache locale non sia disponibile. Questo valore viene aggiunto all'elenco di origine della patch quando viene applicato a un prodotto. Opzionale. |
MinimumRequiredMsiVersion | Impostare questa proprietà per forzare Patchwiz.dll generare una patch che richiede una versione specifica di Windows Installer. Questo valore della proprietà consente di determinare quale valore usare per il riepilogo conteggio parole proprietà del pacchetto patch. Il valore di questa proprietà corrisponde alla Riepilogo conteggio pagine proprietà del pacchetto di installazione. Se un file con estensione pcp ha un valore MinimumRequiredMsiVersion uguale a 200, Patchwiz.dll imposta la proprietà riepilogo conteggio parole del pacchetto patch su 3. In questo modo si impedisce che la patch venga applicata dalla versione di Windows Installer precedente alla versione 2.0. Se un file con estensione pcp ha un valore MinimumRequiredMsiVersion uguale a 300, Patchwiz.dll imposta la proprietà riepilogo conteggio parole proprietà del pacchetto patch su 4. Ciò impedisce l'applicazione della patch da parte delle versioni di Windows Installer precedenti alla versione 3.0. Se un file con estensione pcp ha un valore MinimumRequiredMsiVersion uguale a 310, Patchwiz.dll imposta il riepilogo riepilogo conteggio parole proprietà del pacchetto patch su 5. In questo modo si impedisce che la patch venga applicata da Windows Installer precedente alla versione 3.1. Se un file con estensione pcp ha un valore MinimumRequiredMsiVersion uguale a 400, Patchwiz.dll imposta la proprietà riepilogo conteggio parole del pacchetto patch su 6. In questo modo si impedisce che la patch venga applicata da Windows Installer precedente alla versione 4.0. |
PATCH_CACHE_ENABLED | Impostare questa proprietà su 1 per memorizzare nella cache le informazioni di creazione della patch nella cartella specificata dalla proprietà PATCH_CACHE_DIR. La memorizzazione nella cache delle patch aumenta la velocità di creazione delle patch durante la ricreazione di una nuova patch dopo l'aggiornamento dell'immagine di aggiornamento. Questa proprietà richiede Patchwiz.dll in Windows Installer 2.0 o versione successiva. Per informazioni, vedere memorizzazione nella cache delle informazioni sulle patch (Patchwiz.dll). |
PATCH_CACHE_DIR | Impostare questa proprietà sul nome della cartella in cui sono archiviate le informazioni della patch memorizzate nella cache. Patchwiz.dll crea questa cartella, se necessario. La cartella deve trovarsi in un'unità con spazio su disco sufficiente. Questa proprietà viene utilizzata solo se la proprietà PATCH_CACHE_ENABLED è impostata su 1. La tabella proprietà accetta variabili di ambiente per i percorsi che iniziano con la versione 4.0 di Patchwiz.dll. Usare il formato Windows per la variabile di ambiente, ad esempio %ENV_VAR%. Non utilizzare il tipo di dati colonna formattato. |
SEQUENCE_DATA_GENERATION_DISABLED | Impostare questa proprietà su 1 (uno) per impedire la generazione automatica delle informazioni di sequenziazione delle patch. Se questa proprietà è assente, le informazioni di sequenziazione vengono generate e aggiunte automaticamente. |
SEQUENCE_DATA_SUPERSEDENCE | Impostare questa proprietà su 0 (zero) o 1 (uno) per scrivere tale valore nel campo Attributi di tutte le righe della tabella MsiPatchSequence. |
TrustMsi | Impostare questa proprietà su 1 nella tabella proprietà per usare le informazioni sulla versione del file, le dimensioni e i valori hash forniti nel file .msi. Se questa proprietà è impostata ma le informazioni nel file di .msi non sono corrette, la patch creata potrebbe non funzionare correttamente. È consigliabile aggiornare i file di destinazione e di .msi aggiornati usando MsiFiler.exe. Il valore predefinito per questa proprietà è 0. Disponibile a partire da Patchwiz.dll versione 4.0. |