InstallValidate Action

De actie InstallValidate controleert of alle volumes waaraan kosten zijn toegewezen, voldoende ruimte hebben voor de installatie. De actie InstallValidate beëindigt de installatie met een fatale fout als een volume weinig schijfruimte heeft.

Met de actie InstallValidate wordt de gebruiker ook op de hoogte gebracht als een of meer bestanden die moeten worden overschreven of verwijderd, momenteel worden gebruikt door een actief proces. Zie Systeem opnieuw opstartenvoor meer informatie.

Sequentiebeperkingen

De CostFinalize-actie en eventuele reeksen in het dialoogvenster UI waarmee de gebruiker selectiestatussen en/of mappen kan wijzigen, moet worden gesequentieerd voordat de actie InstallValidate wordt uitgevoerd.

aangepaste acties die de installatiestatus van onderdelen of onderdelen wijzigen, moeten vóór de actie InstallValidate worden gesequentieerd.

ActionData-berichten

Er zijn geen ActionData-berichten.

Opmerkingen

Normaal gesproken moet een eerdere reeks gebruikersinterfacevensters dezelfde verificatie uitvoeren als de actie InstallValidate wanneer de gebruiker probeert het kopiëren van bestanden te starten. Deze gebruikersinterfacedialoogvensterreeks moet een dialoogvenster Onvoldoende schijfruimte weergeven als de geselecteerde volumes onvoldoende ruimte hebben voor de installatie. De dialoogvensters van de gebruikersinterface moeten zodanig worden gemaakt dat de gebruiker niet doorgaat met de installatie als er onvoldoende schijfruimte is. In het geval van een stille installatie is er geen gebruikersinterface en de actie InstallValidate beëindigt de installatie als er onvoldoende schijfruimte is. De oorzaak van de voortijdige beëindiging wordt vastgelegd in het logboekbestand als logboekregistratie is ingeschakeld.

Een vermelding wordt toegevoegd aan een interne FilesInUse-tabel als een bestand wordt overschreven of verwijderd terwijl het is geopend voor uitvoering of wijziging door een proces tijdens het bestand kostende. De tabel FilesInUse bevat kolommen voor de naam en het volledige pad van het bestand. Wanneer de actie InstallValidate wordt uitgevoerd, voert het installatieprogramma een query uit op de tabel FilesInUse voor vermeldingen en bepaalt de naam van het proces met behulp van het bestand. Met de actie InstallValidate wordt één record toegevoegd aan de ListBox gebruikersinterfacetabel voor elk uniek proces dat door deze query wordt geïdentificeerd. De record bevat de volgende waarden in elke kolom:

eigenschap: FileInUseProcess

waarde: naam van proces

Text: Tekst in het bijschrift van het hoofdvenster van het proces

Met de actie InstallValidate wordt vervolgens het dialoogvenster Bestanden in gebruik weergegeven. In dit dialoogvenster worden de processen weergegeven die moeten worden afgesloten om te voorkomen dat het systeem opnieuw moet worden opgestart om bestanden in gebruik te vervangen.

De actie InstallValidate voert een query uit op de dialoogvenster tabel voor een geschreven dialoogvenster met de gereserveerde naam FilesInUse dialoogvenster en geeft deze weer. Dit dialoogvenster moet een keuzelijstlijst bevatten besturingselement dat is gekoppeld aan een eigenschap met de naam FileInUseProcess. Dit dialoogvenster heeft standaard een knopafsluiten, opnieuw proberen of knop negeren, maar dit is aan de auteur van de gebruikersinterface. Elke knop moet zijn gekoppeld aan een EndDialog ControlEvent in de tabel ControlEvent. De actie InstallValidate reageert als volgt op de waarde die wordt geretourneerd door de DoAction ControlEvent, zoals bepaald door een van deze EndDialog argumenten die zijn gekoppeld aan de knop die door de gebruiker is gepusht:

opnieuw proberen: alle waarden die zijn toegevoegd aan de tabel, worden gewist en het hele bestand kostende procedure wordt herhaald, waarbij opnieuw wordt gecontroleerd op bestanden die nog in gebruik zijn. Als een of meer processen nog steeds worden geïdentificeerd als het gebruik van bestanden die moeten worden overschreven of verwijderd, herhaalt het proces; Anders retourneert InstallValidate het besturingselement naar het installatieprogramma met de status msiDoActionStatusSuccess.

Afsluiten: de actie InstallValidate retourneert direct het besturingselement naar het installatieprogramma met de status msiDoActionStatusUserExit. Hiermee wordt de installatie beëindigd.

Een andere retourwaarde: de actie InstallValidate retourneert onmiddellijk het besturingselement naar het installatieprogramma met de status msiDoActionStatusSuccess. Aangezien een of meer bestanden nog in gebruik zijn, moeten de volgende InstallFiles en/of InstallAdminPackage acties de ingebruikste bestanden plannen die moeten worden vervangen of verwijderd wanneer het systeem opnieuw wordt opgestart.

Als er geen ListBox tabel in de database staat, wordt InstallValidate zonder fout afgesloten.

De puntkomma is het lijstscheidingsteken voor transformaties, bronnen en patches en mag niet worden gebruikt in deze bestandsnamen of paden.

Bestanden die als alleen-lezen zijn gemarkeerd op een alleen-lezenlocatie, worden nooit in gebruik genomen door het installatieprogramma.

Er wordt een standaarddialoogvenster onvoldoende schijfruimte met afbreken en knoppen voor opnieuw proberen aan de gebruiker worden weergegeven als het niveau van de gebruikersinterface eenvoudig is.