Tabella delle proprietà (Patchwiz.dll)

  • Articolo

La tabella Properties contiene le impostazioni globali per il pacchetto patch. La tabella Properties è necessaria nel database di creazione della patch (file con estensione pcp) e viene usata dalla funzione UiCreatePatchPackageEx .

La tabella Properties include le colonne seguenti.

Colonna Tipo Chiave Nullable
Nome text S N
Valore text S

 

Colonne

Nome

Nome di una proprietà di creazione di patch.

Valore

Valore della proprietà di creazione della patch.

Commenti

Nella tabella seguente vengono identificate le stringhe delle proprietà di creazione di patch che possono essere immesse nella tabella delle proprietà del file con estensione pcp.

Proprietà Descrizione
AllowLaxValidationFlags Se questa proprietà è impostata su 1, una voce viene scritta nel log 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) della proprietà ProductVersion può differire tra le immagini aggiornate e le 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 gli interi nuovi file non vengono rimossi dopo aver creato il pacchetto patch. Si tratta essenzialmente del contenuto del file MSP prima di essere incorporato nel pacchetto patch. Ciò 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 interamente durante la creazione del pacchetto patch invece di creare una patch di file binari. I file di 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 rilevata come installata nel computer dell'utente e registrata con Windows Installer, viene annullata la registrazione dal prodotto appropriato e le relative trasformazioni di 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. Facoltativa.
ListOfTargetProductCodes Elenco dei codici product per i prodotti che potrebbero ricevere questa patch. Si tratta di un elenco delimitato da punto e virgola dei valori della proprietà ProductCode . 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 modello .msi file da cui esportare la tabella patch e la tabella PatchPackage. Facoltativo.La tabella delle proprietà accetta le 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 formattata .
OptimizePatchSizeForLargeFiles Questa proprietà viene impostata quando il valore esiste e non è "0". Quando questa proprietà è impostata, le patch per i file superiori a circa 4 MB di dimensioni 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 da generare. 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 formattata .
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. Facoltativa.
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 il valore da usare per la proprietà riepilogo conteggio Word del pacchetto patch. Il valore di questa proprietà è dello stesso formato della proprietà Riepilogo conteggio pagine del pacchetto di installazione. Se un file con estensione pcp ha un valore MinimumRequiredMsiVersion uguale a 200, Patchwiz.dll imposta la proprietà Word Count Summary del pacchetto patch su 3. Ciò impedisce l'applicazione della patch 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 Word 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 la proprietà riepilogo conteggio Word del pacchetto patch su 5. Ciò impedisce l'applicazione della patch da Parte di 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à Word Count Summary del pacchetto patch su 6. Ciò impedisce l'applicazione della patch da parte di 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. 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 che archivia le informazioni sulle 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 usata solo se la proprietà PATCH_CACHE_ENABLED è impostata su 1. La tabella Proprietà accetta variabili di ambiente per i percorsi a partire dalla versione 4.0 di Patchwiz.dll. Usare il formato Windows per la variabile di ambiente, ad esempio %ENV_VAR%. Non usare il tipo di dati di colonna formattato .
SEQUENCE_DATA_GENERATION_DISABLED Impostare questa proprietà su 1 (una) per impedire la generazione automatica delle informazioni di sequenziazione delle patch. Se questa proprietà è assente, le informazioni di sequenziazione vengono generate automaticamente e aggiunte.
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 .msi non sono corrette, la patch creata potrebbe non funzionare correttamente. È necessario aggiornare i file di destinazione e aggiornati .msi usando MsiFiler.exe. Il valore predefinito per questa proprietà è 0. Disponibile a partire da Patchwiz.dll versione 4.0.