InstallValidate művelet

Az InstallValidate művelet ellenőrzi, hogy minden kötetnek, amelyhez költség tartoznak, elegendő hely áll-e rendelkezésre a telepítéshez. Az InstallValidate művelet végzetes hibával zárja le a telepítést, ha bármilyen kötet kevés lemezterülettel rendelkezik.

Az InstallValidate művelet arról is értesíti a felhasználót, hogy egy vagy több felülírni vagy eltávolítani kívánt fájlt jelenleg egy aktív folyamat használ. További információ: Rendszer újraindítása.

Sorozatkorlátozások

A CostFinalize műveletet, valamint azokat a felhasználói felületi párbeszédpanel-sorozatokat, amelyek lehetővé teszik a felhasználó számára a kijelölési állapotok és/vagy könyvtárak módosítását, az InstallValidate művelet előtt kell sorrendbe helyezni.

funkciók vagy összetevők telepítési állapotát módosító egyéni műveleteket az InstallValidate művelet előtt kell végrehajtani.

ActionData-üzenetek

Nincsenek ActionData-üzenetek.

Megjegyzések

Egy korábbi felhasználói felület párbeszédpanel-sorozatának általában ugyanazt az ellenőrzést kell végrehajtania, mint az InstallValidate műveletnek, amikor a felhasználó megkísérli kezdeményezni a fájlok másolását. A felhasználói felület párbeszédpanel-sorozatának Lemezterületen kívül párbeszédpanelt kell megjelenítenie, ha a kijelölt kötetek nem rendelkeznek elegendő szabad területtel a telepítéshez. A felhasználói felület párbeszédpaneleit úgy kell létrehozni, hogy a felhasználó ne folytassa a telepítést, ha nincs elegendő lemezterület. Csendes telepítés esetén nincs felhasználói felület, és az InstallValidate művelet leállítja a telepítést, ha nincs elegendő lemezterület. Ha a naplózás engedélyezve van, a rendszer rögzíti az idő előtti leállás okát a naplófájlban.

Bejegyzést ad hozzá egy belső FilesInUse táblához, ha bármely fájl felülíródik vagy el lett távolítva, miközben a fájl a fájl költségszámításisorán bármilyen folyamattal végrehajtásra vagy módosításra nyitva van. A FilesInUse tábla a fájl nevének és teljes elérési útjának oszlopait tartalmazza. Az InstallValidate művelet végrehajtásakor a telepítő lekérdezi a FilesInUse táblát a bejegyzésekhez, és meghatározza a fájllal végzett folyamat nevét. Az InstallValidate művelet egy rekordot ad hozzá a ListBox felhasználói felület táblához a lekérdezés által azonosított egyedi folyamatokhoz. A rekord minden oszlopban a következő értékeket tartalmazza:

tulajdonság: FileInUseProcess

Érték: Folyamat neve

Szöveg: A folyamat főablakának feliratában található szöveg

Az InstallValidate művelet ezután megjeleníti a Használatban lévő fájlok párbeszédpanelt. Ez a párbeszédpanel megjeleníti azokat a folyamatokat, amelyeket le kell állítani annak érdekében, hogy ne kelljen újraindítani a rendszert a használt fájlok cseréjéhez.

Az InstallValidate művelet lekérdezi a Párbeszédpanel táblát egy fenntartott névvel rendelkező párbeszédpanelhez, FilesInUse párbeszédpanelen, és megjeleníti azt. Ennek a párbeszédpanelnek tartalmaznia kell egy ListBox vezérlőt, amely egy FileInUseProcess nevű tulajdonsághoz van kötve. Ez a párbeszédpanel konvenció szerint kilépési, Újrapróbálkozásivagy Mellőzés gombot, de ez a felhasználói felület szerzőjén múlik. Minden gombot egy EndDialog ControlEventhez kell kötni a ControlEvent táblában. Az InstallValidate művelet a következőképpen válaszol a DoAction ControlEvent által visszaadott értékre, a felhasználó által leküldött gombhoz társított egyik EndDialog- argumentumnak megfelelően:

Újrapróbálkozási: A ListBox táblához hozzáadott összes érték törlődik, és a teljes fájl költségszámítási eljárás ismétlődik, a még használatban lévő fájlok újraellenőrzése. Ha egy vagy több folyamat továbbra is úgy van azonosítva, hogy felülírandó vagy törölendő fájlokat használ, a folyamat ismétlődik; ellenkező esetben az InstallValidate az msiDoActionStatusSuccess állapotú vezérlőt adja vissza a telepítőnek.

Kilépés a: Az InstallValidate művelet azonnal visszaadja a vezérlőt az msiDoActionStatusUserExit állapotú telepítőnek. Ez leállítja a telepítést.

Bármely más visszatérési érték: Az InstallValidate művelet azonnal visszaadja a vezérlőt az msiDoActionStatusSuccess állapotú telepítőnek. Ebben az esetben, mivel egy vagy több fájl még használatban van, a következő InstallFiles és/vagy InstallAdminPackage műveleteknek ütemezniük kell a használatban lévő fájl(ok) cseréjét vagy törlését a rendszer újraindításakor.

Ha nincs ListBox tábla az adatbázisban, az InstallValidate hiba nélkül kilép.

A pontosvessző az átalakítások, források és javítások listaelválasztója, és nem használható ezekben a fájlnevekben vagy elérési utakban.

A telepítő soha nem tekinti használatnak az írásvédett helyen megjelölt fájlokat.

Ha a felhasználói felület szintje alapszintű, megjelenik egy alapértelmezett Lemezterületen kívül párbeszédpanel, amely megszakítja a és újrapróbálkozási gombokat.