Táblázat frissítése
A frissítési táblázat főbb frissítésekszükséges információkat tartalmazza. A telepítő frissítési képességeinek teljes körű engedélyezéséhez minden csomagnak rendelkeznie kell egy UpgradeCode tulajdonságával és frissítési táblájával. A frissítési tábla minden rekordja a frissítési kód, a termékverzió és a nyelvi információk jellemző kombinációját adja a frissítés által érintett termékek azonosításához. Amikor a FindRelatedProducts művelet észleli a rendszeren telepített érintett terméket, hozzáfűzi a termékkódot az ActionProperty oszlopban megadott tulajdonsághoz. A RemoveExistingProducts művelet és a MigrateFeatureStates művelet csak az ActionProperty oszlopban felsorolt termékeket távolítja el vagy migrálja.
A Frissítés tábla az alábbi táblázatban látható oszlopokat tartalmazza.
| Oszlop | Típus | Kulcs | Nullázható |
|---|---|---|---|
| UpgradeCode | GUID | Y | N |
| VersionMin | Szöveg | Y | Y |
| VersionMax | Szöveg | Y | Y |
| Nyelv | Szöveg | Y | Y |
| Attribútumok | egész szám | Y | N |
| Eltávolít | formázott | N | Y |
| ActionProperty | azonosító | N | N |
Oszlopok
-
UpgradeCode
-
Az oszlopban található UpgradeCode tulajdonság határozza meg az összes olyan termék frissítési kódját, amelyet a FindRelatedProducts művelet észlel.
-
VersionMin
-
Az FindRelatedProductsáltal észlelt termékverziók tartományának alsó határa. Adja meg msidbUpgradeAttributesVersionMinInclusive attribútumokban a VersionMin tartományba való belefoglalásához. Ha a VersionMin egy üres sztring ("") értékével egyenlő, akkor a kiértékelése megegyezik a 0-zal. Ha a VersionMin értéke null, a FindRelatedProducts figyelmen kívül hagyja msidbUpgradeAttributesVersionMinInclusive, és észleli az összes korábbi verziót. A VersionMin és a VersionMax nem lehet null értékű.
A VersionMin-nek érvényes termékverziónak kell lennie a ProductVersion tulajdonság leírásának megfelelően. Vegye figyelembe, hogy a Windows Installer csak a termékverzió első három mezőjét használja. Ha egy negyedik mezőt is befoglal a termékverzióba, a telepítő figyelmen kívül hagyja a negyedik mezőt.
-
VersionMax
-
A FindRelatedProducts művelet által észlelt termékverziók tartományának felső határa. Adja meg msidbUpgradeAttributesVersionMaxInclusive attribútumokban a VersionMax tartományba való belefoglalásához. Ha a VersionMax egy üres sztring (""), akkor a kiértékelése megegyezik a 0-zal. Ha a VersionMax null értékű, a FindRelatedProducts figyelmen kívül hagyja msidbUpgradeAttributesVersionMaxInclusive, és észleli a VersionMin és msidbUpgradeAttributesVersionMinInclusiveáltal megadott alsó határnál nagyobb (vagy annál nagyobb) termékverziókat. A VersionMin és a VersionMax nem lehet null értékű.
A VersionMax-nak érvényes termékverziónak kell lennie a ProductVersion tulajdonság leírása szerint. Vegye figyelembe, hogy a Windows Installer csak a termékverzió első három mezőjét használja. Ha egy negyedik mezőt is befoglal a termékverzióba, a telepítő figyelmen kívül hagyja a negyedik mezőt.
-
nyelv
-
A FindRelatedProducts által észlelt nyelvek. Adja meg a számnyelv-azonosítók (LANGID) vesszővel elválasztott listáját. Adja meg msidbUpgradeAttributesLanguagesExclusive attribútumokban, hogy észlelje a nyelvben felsorolt nyelveken nem szereplő összes nyelvet. Ha a nyelv null értékű vagy üres sztring (""), a FindRelatedProducts figyelmen kívül hagyja msidbUpgradeAttributesLanguagesExclusive, és minden nyelvet észlel.
-
attribútumok
-
Ez az oszlop bitjelölőket tartalmaz a Frissítés tábla attribútumait megadva.
Bitjelző neve Tizedes Hexadecimális Attribútum msidbUpgradeAttributesMigrateFeatures 1 0x001 A szolgáltatásállapotok migrálása a MigrateFeatureStates művelet logikájának engedélyezésével. msidbUpgradeAttributesOnlyDetect 2 0x002 Felismeri a termékeket és alkalmazásokat, de nem távolítja el. msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Termék vagy alkalmazás eltávolításának sikertelensége esetén folytatja a telepítést. msidbUpgradeAttributesVersionMinInclusive 256 0x100 Észleli a verziótartományt, beleértve a VersionMin értékét is. msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Észleli a verziótartományt, beleértve a VersionMax értékét is. msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Az összes nyelvet észleli, kivéve a Nyelv oszlopban felsorolt nyelveket. -
Eltávolítás
-
A telepítő a REMOVE tulajdonságot az oszlopban megadott funkciókra állítja be. Az eltávolítandó funkciók futásidőben határozhatók meg. A mezőben megadott formázott sztringnek vesszővel tagolt szolgáltatásnevek listájára kell kiértékelnie. Például: [Feature1],[Feature2],[Feature3]. A rendszer nem távolít el szolgáltatásokat, ha a mező formázott szöveget tartalmaz, amely üres sztring ("") lesz kiértékelve. A telepítő csak akkor állítja be a REMOVE=ALL értéket, ha az Eltávolítás mező üres. Figyelje meg az üres sztring és az üres mező közötti különbséget. Ha a mező üres, akkor null értékű.
-
ActionProperty
-
Amikor a FindRelatedProducts művelet észlel egy, a rendszeren telepített kapcsolódó terméket, hozzáfűzi a termékkódot a mezőben megadott tulajdonsághoz. Az oszlopban megadott tulajdonságnak nyilvános tulajdonságnak kell lennie, és a csomag szerzőjének hozzá kell adnia a tulajdonságot a SecureCustomProperties tulajdonsághoz. A Frissítés tábla minden sorának egyedi ActionProperty értékkel kell rendelkeznie. A FindRelatedProducts után ennek a tulajdonságnak az értéke egy lista termékkódja, amely pontosvesszővel (;)) van elválasztva a rendszeren.
Érvényesítés