Udostępnij za pośrednictwem

Tabela właściwości (Patchwiz.dll)

  • Artykuł

Tabela właściwości zawiera ustawienia globalne pakietu poprawek. Tabela Właściwości jest wymagana w bazie danych tworzenia poprawek (plik pcp) i jest używana przez funkcję UiCreatePatchPackageEx.

Tabela Właściwości zawiera następujące kolumny.

Kolumna Typ Klucz Nullable
Nazwa Tekst Y N
Wartość Tekst Y

 

Kolumny

nazwa

Nazwa właściwości tworzenia poprawek.

wartość

Wartość właściwości tworzenia poprawek.

Uwagi

W poniższej tabeli przedstawiono ciągi właściwości tworzenia poprawek, które można wprowadzić w tabeli właściwości pliku pcp.

Własność Opis
AllowLaxValidationFlags Jeśli ta właściwość jest ustawiona na 1, wpis zostanie zapisany w dzienniku i nie zostanie zwrócony żaden błąd, jeśli nie można zweryfikować pola ProductValidateFlags w tabeli TargetImages. Ta właściwość powinna być ustawiana tylko wtedy, gdy autor poprawki zmienił wartość w polu ProductValidateFlags. Wartość domyślna dla tej właściwości to 0. Dostępne począwszy od wersji Patchwiz.dll 4.0.
AllowProductCodeMismatches Ustaw wartość "1" dla wartości True, jeśli właściwośćProductCode może się różnić między uaktualnionymi obrazami wymienionymi w tabeli UpgradeImages a obrazami docelowymi wymienionymi w tabeli TargetImages. Ustaw wartość "0" lub pustą na wartość False, jeśli kody produktów muszą być takie same.
AllowProductVersionMajorMismatches Ustaw wartość "1" na wartość True, jeśli pierwsze pole (pole wersji głównej) właściwości ProductVersion może się różnić między uaktualnionymi obrazami a obrazami docelowymi. Ustaw wartość "0" lub pustą na wartość Fałsz, jeśli wersje główne muszą być zgodne.
ApiPatchingSymbolFlags 8-cyfrowy szesnastkowy liczba całkowita reprezentująca kombinację flag użycia symbolu poprawki do użycia podczas tworzenia poprawki pliku binarnego. Wartość domyślna to 0x00000000. Zobacz Patchapi.h, aby uzyskać pełną listę możliwych flag PATCH_SYMBOL_*. Aby uzyskać więcej informacji na temat plików symboli, zobacz słownik.
DontRemoveTempFolderWhenFinished Ustaw wartość "1" na wartość True, jeśli folder tymczasowy zawierający przekształcenia, poprawki na poziomie bajtu i całe nowe pliki nie są usuwane po utworzeniu pakietu poprawek. Jest to zasadniczo zawartość pliku msp przed osadzoną w pakiecie poprawek. Może to być przydatne w przypadku debugowania poprawek. Ustaw wartość "0" lub wartość pustą na wartość Fałsz, jeśli folder tymczasowy ma zostać usunięty.
IncludeWholeFilesOnly Ustaw wartość "1", aby oznaczać wartość True, jeśli pliki, które są zmieniane, mają być uwzględniane w całości podczas tworzenia pakietu poprawek zamiast tworzenia poprawki pliku binarnego. Pliki poprawek będą większe, ale interfejs API działa szybciej. Ustaw wartość "0" lub pustą, aby oznaczać wartość False w przypadku tworzenia poprawki pliku binarnego.
ListOfPatchGUIDsToReplace Lista identyfikatorów PatchGUID bez ogranicznika. Jeśli którykolwiek z tych poprawek zostanie zainstalowany na komputerze użytkownika i zarejestrowany w Instalatorze Windows, zostaną one wyrejestrowane z odpowiedniego produktu, a ich przekształcenia poprawek zostaną usunięte z listy przekształceń skojarzonych z produktem. Należy pamiętać, że usunięcie poprawki nie ma wpływu na żadne pliki, tylko rejestrację poprawki. Fakultatywny.
ListOfTargetProductCodes Lista kodów produktów dla produktów, które mogą otrzymać tę poprawkę. Jest to rozdzielana średnikami lista wartości właściwości ProductCode. Jeśli lista zaczyna się od gwiazdki, lista kodów produktów jest generowana na podstawie plików .msi obiektów docelowych wymienionych w tabeli TargetImages. Jeśli jakiekolwiek kody produktów są zgodne z wiodącą gwiazdką, są dołączane do listy, która zastępuje gwiazdkę. Jeśli właściwość nie jest ustawiona, lista kodów produktów jest generowana na podstawie plików .msi obiektów docelowych wymienionych w tabeli TargetImages.
MsiFileToUseToCreatePatchTables Pełna ścieżka do pliku .msi szablonu, z którego ma być eksportowana tabela poprawek i PatchPackage Table. Optional.Tabela Właściwości akceptuje zmienne środowiskowe dla ścieżek rozpoczynających się od wersji 4.0 Patchwiz.dll. Użyj formatu systemu Windows dla zmiennej środowiskowej, takiej jak %ENV_VAR%. Nie używaj sformatowanego typu danych kolumny.
OptimizePatchSizeForLargeFiles Ta właściwość jest ustawiana, gdy wartość istnieje i nie jest "0". Po ustawieniu tej właściwości poprawki dla plików o rozmiarze większym niż około 4 MB mogą być mniejsze.
PatchGUID Identyfikator GUID dla tego pakietu poprawek (plik msp). Każdy pakiet poprawek musi mieć unikatową wartość PatchGUID. Wymagane.
PatchOutputPath Pełna ścieżka, w tym nazwa pliku poprawki, który ma zostać wygenerowany. Jeśli szPatchPath zostanie przekazana przez funkcję UiCreatePatchPackageEx, zostanie użyta przekazana wartość. Ta właściwość jest wymagana, jeśli szPatchPath ma wartość null lub pusty ciąg. Tabela Właściwości akceptuje zmienne środowiskowe dla ścieżek rozpoczynających się od wersji 4.0 Patchwiz.dll. Użyj formatu systemu Windows dla zmiennej środowiskowej, takiej jak %ENV_VAR%. Nie używaj sformatowanego typu danych kolumny.
PatchSourceList Źródło używane do lokalizowania pliku msp dla poprawki w przypadku niedostępności lokalnie buforowanej kopii. Ta wartość jest dodawana do źródłowej listy poprawek po zastosowaniu jej do produktu. Fakultatywny.
MinimumRequiredMsiVersion Ustaw tę właściwość, aby wymusić Patchwiz.dll wygenerowanie poprawki wymagającej określonej wersji Instalatora Windows. Ta wartość właściwości pomaga określić, jakiej wartości należy użyć dla Właściwość podsumowania liczby wyrazów pakietu poprawek. Wartość tej właściwości jest taka sama jak właściwość Liczba stron właściwość pakietu instalacyjnego. Jeśli plik pcp ma wartość MinimumRequiredMsiVersion równą 200, Patchwiz.dll ustawia właściwość podsumowania liczby wyrazów pakietu poprawek na 3. Zapobiega to zastosowaniu poprawki przez instalatora Windows w wersji starszej niż 2.0.
Jeśli plik pcp ma wartość MinimumRequiredMsiVersion równą 300, Patchwiz.dll ustawia właściwość podsumowania liczby wyrazów właściwość pakietu poprawki na 4. Zapobiega to stosowaniu poprawki przez wersje Instalatora Windows starsze niż wersja 3.0.
Jeśli plik pcp ma wartość MinimumRequiredMsiVersion równą 310, Patchwiz.dll ustawia właściwość podsumowania liczby wyrazów właściwość pakietu poprawki na 5. Zapobiega to zastosowaniu poprawki przez Instalatora Windows starszej niż wersja 3.1.
Jeśli plik pcp ma wartość MinimumRequiredMsiVersion równą 400, Patchwiz.dll ustawia właściwość podsumowania liczby wyrazów pakietu poprawek na wartość 6. Zapobiega to zastosowaniu poprawki przez Instalatora Windows starszej niż wersja 4.0.
PATCH_CACHE_ENABLED Ustaw tę właściwość na 1, aby buforować informacje o tworzeniu poprawek w folderze określonym przez właściwość PATCH_CACHE_DIR. Buforowanie poprawek zwiększa szybkość tworzenia poprawek podczas ponownego tworzenia nowej poprawki po zaktualizowaniu obrazu aktualizacji. Ta właściwość wymaga Patchwiz.dll w Instalatorze Windows 2.0 lub nowszym. Aby uzyskać informacje, zobacz Patch Information Caching (Patchwiz.dll).
PATCH_CACHE_DIR Ustaw tę właściwość na nazwę folderu, który przechowuje buforowane informacje o poprawkach. Patchwiz.dll tworzy ten folder w razie potrzeby. Folder powinien znajdować się na dysku z wystarczającą ilością miejsca na dysku. Ta właściwość jest używana tylko wtedy, gdy właściwość PATCH_CACHE_ENABLED jest ustawiona na 1. Tabela Właściwości akceptuje zmienne środowiskowe dla ścieżek rozpoczynających się od wersji 4.0 Patchwiz.dll. Użyj formatu systemu Windows dla zmiennej środowiskowej, takiej jak %ENV_VAR%. Nie używaj sformatowanego typu danych kolumny.
SEQUENCE_DATA_GENERATION_DISABLED Ustaw tę właściwość na 1 (jedną), aby zapobiec automatycznemu generowaniu informacji sekwencjonowania poprawek. Jeśli ta właściwość jest nieobecna, informacje dotyczące sekwencjonowania są generowane i dodawane automatycznie.
SEQUENCE_DATA_SUPERSEDENCE Ustaw tę właściwość na 0 (zero) lub 1 (jeden), aby zapisać tę wartość w polu Atrybuty wszystkich wierszy w tabeli msiPatchSequence .
TrustMsi Ustaw tę właściwość na wartość 1 w tabeli właściwości, aby użyć informacji o wersji pliku, rozmiaru i wartości skrótu podanych w pliku .msi. Jeśli ta właściwość jest ustawiona, ale informacje w pliku .msi są niepoprawne, utworzona poprawka może nie działać poprawnie. Należy zaktualizować plik docelowy i uaktualniony .msi przy użyciu MsiFiler.exe. Wartość domyślna dla tej właściwości to 0. Dostępne począwszy od wersji Patchwiz.dll 4.0.