ImageFamilies Table (Patchwiz.dll)
Een installatiekopieënfamilie is een groep van een of meer bijgewerkte installatiekopieën van een product dat is bijgewerkt naar de meest recente versie. Elke bijgewerkte installatiekopieën kunnen slechts tot één familie behoren. Bijgewerkte installatiekopieën die behoren tot een installatiekopieënfamilie delen een of meer bestanden. Elke installatiekopiefamilie heeft een eigen cabinetbestand in het MSP-bestand met de binaire patches en nieuwe bestanden die nodig zijn om de verschillen tussen doel- en bijgewerkte bestanden bij te werken. Het cabinetbestand repliceert niet de binaire patches en nieuwe bestanden die worden gebruikt door de gedeelde bestanden.
Een ImageFamilies-tabel met ten minste één record is vereist in elke database voor het maken van patches (.pcp-bestand). Deze tabel wordt gebruikt door de functie UiCreatePatchPackageEx.
De tabel ImageFamilies bevat de patchinformatie die moet worden toegevoegd aan de Media-tabel. Met een patch wordt één vermelding aan de mediatabel toegevoegd. Elke record in de tabellen ImageFamilies verwijst naar een groep gerelateerde productafbeeldingen die zijn bijgewerkt naar de meest recente versie van het product.
De tabel ImageFamilies bevat de volgende kolommen. Een null-waarde kan worden gebruikt in de kolommen MediaSrcPropName, MediaDiskId en FileSequenceStart als de patch wordt toegepast met Windows Installer en Patchwiz.dll versie 2.0.
| Kolom | Type | Sleutel | Null-waarde |
|---|---|---|---|
| Familie | Sms | Y | N |
| MediaSrcPropName | Sms | Y | |
| MediaDiskId | geheel getal | Y | |
| FileSequenceStart | geheel getal | Y | |
| DiskPrompt | Sms | Y | |
| VolumeLabel | Sms | Y |
Kolommen
-
Familie
-
De waarde die in dit veld is ingevoerd, is een id voor een groep gerelateerde productafbeeldingen die zijn bijgewerkt naar de meest recente versie van het product. Beperkt tot een totaal van 8 alfanumerieke tekens of onderstrepingstekens. Het installatieprogramma sluit een cabinetstream in het Windows Installer-patchbestand (.msp-bestand) in voor elke familie in de tabel. Het cabinet bevat de binaire patches en nieuwe bestanden die nodig zijn om een doelinstallatiekopieën bij te werken naar een bijgewerkte afbeelding van het product. Het installatieprogramma voorvoegt de familienaam met PCW_CAB_ om de stroomnaam van het cabinet te genereren die deze invoert in het veld Cabinet van de nieuwe Media-tabel vermelding.
-
MediaSrcPropName
-
De waarde die is ingevoerd in het veld Bron van de nieuwe tabel Media vermelding van de bijgewerkte afbeelding. Dit veld kan alleen null zijn als u versie 2.0 van Patchwiz.dll gebruikt en als de MinimumRequiredMsiVersion in de tabel Properties (Patchwiz.dll) is ingesteld op 200.
-
MediaDiskId
-
Het installatieprogramma voert deze waarde in het veld DiskId van de nieuwe Media-tabel in record. De DiskID-waarde moet groter zijn dan elke huidige DiskID in het doelpakket. De limiet voor MediaDiskId is 32767. Dit veld kan alleen null zijn als u versie 2.0 van Patchwiz.dll gebruikt en als de MinimumRequiredMsiVersion in de tabel Properties (Patchwiz.dll) is ingesteld op 200.
-
FileSequenceStart
-
Dit veld is het volgnummer voor het beginbestand. Hetzelfde bestandsreeksnummer mag niet bestaan in twee patches voor hetzelfde product. Om dit te garanderen, moet de waarde in dit veld groter zijn dan alle reeksnummers die worden gebruikt in eerdere patches of in het oorspronkelijke installatiepakket. Het grootste reeksnummer in een patch kan worden bepaald door het totale aantal vermeldingen in het patchkastbestand toe te voegen aan het FileSequenceStart-nummer voor die patch. Een manier om dit te bepalen, is om te kijken naar het DDF-bestand dat is gegenereerd door Patchwiz.dll tijdens het maken van de patch. De limiet voor FileSequenceStart is 32767. Dit veld kan alleen null zijn als u versie 2.0 van Patchwiz.dll gebruikt en als de MinimumRequiredMsiVersion in de tabel Properties (Patchwiz.dll) is ingesteld op 200.
-
DiskPrompt
-
Het installatieprogramma voert deze waarde in het veld DiskPrompt van de nieuwe Media-tabel record in.
-
VolumeLabel
-
Het installatieprogramma voert deze waarde in het veld VolumeLabel van de nieuwe mediarecord in.
Opmerkingen
Met de patch wordt de naam van het cabinet in het MSP-bestand toegevoegd aan het veld Cabinet van de nieuwe record die is toegevoegd aan de Media-tabel. Omdat het een ingesloten cabinet is, wordt de naam voorafgegaan door een #-teken. Met de patch wordt een eigenschap toegevoegd aan het veld Bron van de nieuwe record in de tabel Media. Er kunnen geen twee patches dezelfde broneigenschap hebben.
De bestanden die worden gedeeld binnen de installatiekopieënfamilie, moeten dezelfde bestandstabelsleutel hebben in elke bijgewerkte installatiekopieën van de familie. Bestandstabelsleutels die worden gedeeld tussen de bijgewerkte installatiekopieën, moeten hetzelfde bestand vertegenwoordigen en moeten identiek zijn in alle bijgewerkte installatiekopieën. De bestandstabelsleutel is de waarde die is ingevoerd in de kolom Bestand van de tabel Bestand.
De limiet voor MediaDiskId en FileSequenceStart is 32767. Als u deze limiet wilt verhogen, exporteert u de tabel ImageFamilies naar een .idt-bestand met Msidb.exe en wijzigt u het kolomtype van i2 in i4 of van I2 naar I4 en importeert u het .idt-bestand vervolgens weer in de PCP-database. Transformaties en patches kunnen niet worden gemaakt tussen twee pakketten met verschillende kolomtypen.