ImageFamilies Table (Patchwiz.dll)

Rodzina obrazów to grupa co najmniej jednego uaktualnionego obrazu produktu, który został zaktualizowany do najnowszej wersji. Każdy uaktualniony obraz może należeć tylko do jednej rodziny. Uaktualnione obrazy należące do rodziny obrazów współużytkować co najmniej jeden plik. Każda rodzina obrazów ma własny plik cabinet w pliku msp zawierający poprawki binarne i nowe pliki potrzebne do zaktualizowania różnic między plikami docelowymi i uaktualnionymi. Plik cabinet nie replikuje poprawek binarnych ani nowych plików używanych przez pliki udostępnione.

W każdej bazie danych tworzenia poprawek (pcp) wymagana jest tabela ImageFamilies zawierająca co najmniej jeden rekord. Ta tabela jest używana przez funkcję UiCreatePatchPackageEx.

Tabela ImageFamilies zawiera informacje dotyczące stosowania poprawek, które mają zostać dodane do tabeli Media. Poprawka dodaje jeden wpis do tabeli Media. Każdy rekord w tabelach ImageFamilies odnosi się do grupy powiązanych obrazów produktów, które zostały zaktualizowane do najnowszej wersji produktu.

Tabela ImageFamilies zawiera następujące kolumny. Wartość null można użyć w kolumnach MediaSrcPropName, MediaDiskId i FileSequenceStart, jeśli poprawka jest stosowana w Instalatorze Windows i Patchwiz.dll w wersji 2.0.

Kolumna	Typ	Klucz	Nullable
Rodzina	Tekst	Y	N
MediaSrcPropName	Tekst		Y
MediaDiskId	liczba całkowita		Y
FileSequenceStart	liczba całkowita		Y
DiskPrompt	Tekst		Y
VolumeLabel	Tekst		Y

 

Kolumny

Rodzina

Wartość wprowadzona w tym polu jest identyfikatorem grupy powiązanych obrazów produktów, które zostały zaktualizowane do najnowszej wersji produktu. Ograniczone do łącznie 8 znaków alfanumerycznych lub podkreśleń. Instalator osadza strumień cabinet w pliku poprawki Instalatora Windows (plik msp) dla każdej rodziny w tabeli. Szafa zawiera poprawki binarne i nowe pliki wymagane do zaktualizowania obrazu docelowego do uaktualnionego obrazu produktu. Instalator prefiksuje nazwę rodziny z PCW_CAB_ w celu wygenerowania nazwy strumienia gabinetu, który wprowadza w polu Cabinet nowej tabeli Media.

MediaSrcPropName

Wartość wprowadzona w polu Źródło nowej tabeli Media wpis uaktualnionego obrazu. To pole może mieć wartość null tylko wtedy, gdy używasz wersji 2.0 Patchwiz.dll i jeśli właściwość MinimumRequiredMsiVersion w tabeli właściwości (Patchwiz.dll ) jest ustawiona na 200.

MediaDiskId

Instalator wprowadza tę wartość w polu DiskId nowej tabeli Media rekordu. Wartość DiskID musi być większa niż bieżący identyfikator DiskID w pakiecie docelowym. Limit parametru MediaDiskId wynosi 32767. To pole może mieć wartość null tylko wtedy, gdy używasz wersji 2.0 Patchwiz.dll i jeśli właściwość MinimumRequiredMsiVersion w tabeli właściwości (Patchwiz.dll ) jest ustawiona na 200.

FileSequenceStart

To pole jest numerem sekwencji dla pliku początkowego. Ten sam numer sekwencji plików nie może istnieć w dwóch poprawkach dla tego samego produktu. Aby to zapewnić, wartość w tym polu musi być większa niż wszystkie numery sekwencji używane w poprzednich poprawkach lub w oryginalnym pakiecie instalacyjnym. Największą liczbę sekwencji w poprawce można określić, dodając całkowitą liczbę wpisów w pliku patch cabinet do numeru FileSequenceStart dla tej poprawki. Jednym ze sposobów ustalenia tego jest przyjrzenie się plikowi ddf wygenerowanemu przez Patchwiz.dll podczas tworzenia poprawki. Limit dla fileSequenceStart wynosi 32767. To pole może mieć wartość null tylko wtedy, gdy używasz wersji 2.0 Patchwiz.dll i jeśli właściwość MinimumRequiredMsiVersion w tabeli właściwości (Patchwiz.dll ) jest ustawiona na 200.

DiskPrompt

Instalator wprowadza tę wartość w polu DiskPrompt nowej tabeli Media rekordu.

VolumeLabel

Instalator wprowadza tę wartość w polu VolumeLabel nowego rekordu nośnika.

Uwagi

Poprawka dodaje nazwę szafki w pliku msp do pola Cabinet nowego rekordu dodanego do tabeli Media. Ponieważ jest to osadzony gabinet, nazwa jest poprzedzona znakiem "#". Poprawka dodaje właściwość do pola Źródło nowego rekordu w tabeli Media. Żadne dwie poprawki nie mogą mieć tej samej właściwości źródłowej.

Pliki udostępnione w rodzinie obrazów muszą mieć ten sam klucz tabeli plików w każdym uaktualnionym obrazie rodziny. Wszystkie klucze tabeli plików współużytkowane między uaktualnionymi obrazami muszą reprezentować ten sam plik i muszą być identyczne we wszystkich uaktualnionych obrazach. Klucz tabeli plików to wartość wprowadzona w kolumnie Plik tabeli File.

Limit wartości MediaDiskId i FileSequenceStart wynosi 32767. Aby zwiększyć ten limit, wyeksportuj tabelę ImageFamilies do pliku idt z Msidb.exe i zmień typ kolumny z i2 na i4 lub z I2 na I4, a następnie zaimportuj plik idt z powrotem do bazy danych pcp. Nie można tworzyć przekształceń i poprawek między dwoma pakietami o różnych typach kolumn.