Återställ anpassade åtgärder

När installationsprogrammet bearbetar installationsskriptet genererar det samtidigt ett återställningsskript. Förutom återställningsskriptet sparar installationsprogrammet en kopia av varje fil som tas bort under installationen. Dessa filer sparas i en dold systemkatalog. När installationen är klar tas återställningsskriptet och de sparade filerna bort. Om en installation misslyckas försöker installationsprogrammet återställa de ändringar som gjordes under installationen och återställa datorns ursprungliga tillstånd.

Även om anpassade åtgärder som schemalägger systemåtgärder genom att infoga rader i databastabellen återställs av en återställning av installationen, kan anpassade åtgärder som ändrar systemet direkt eller som utfärdar kommandon till andra systemtjänster inte alltid ångras av en återställning. En anpassad återställningsåtgärd är en åtgärd som installationsprogrammet endast kör under en installationsåterställning, och syftet är att återställa en anpassad åtgärd som har gjort ändringar i systemet.

En anpassad återställningsåtgärd är en typ av anpassad åtgärd för uppskjuten körningeftersom dess körning skjuts upp när den anropas under installationssekvensen. Den skiljer sig från en vanlig uppskjuten anpassad åtgärd eftersom den endast körs under en återställning. En anpassad återställningsåtgärd måste alltid föregå den uppskjutna anpassade åtgärd som den återställer i åtgärdssekvensen. En anpassad återställningsåtgärd bör också hantera fallet där den uppskjutna anpassade åtgärden avbryts mitt under körningen. Om användaren till exempel skulle trycka på knappen Avbryt medan den anpassade åtgärden kördes.

Observera att Återställning av anpassade åtgärder inte kan köras asynkront. Se synkrona och asynkrona anpassade åtgärder.

Komplementet till en anpassad återställningsåtgärd är en checka in anpassad åtgärd. Installationsprogrammet kör en anpassad incheckningsåtgärd under installationssekvensen, kopierar den anpassade åtgärden till återställningsskriptet, men kör inte åtgärden under återställningen.

Observera att en anpassad återställningsåtgärd kanske inte kan ta bort alla ändringar som görs genom att genomföra anpassade åtgärder. Även om installationsprogrammet skriver både återställning och genomför anpassade åtgärder i återställningsskriptet, körs endast anpassade åtgärder när installationsprogrammet har bearbetat installationsskriptet. Incheckning av anpassade åtgärder är de första åtgärderna som ska köras i återställningsskriptet. Om en anpassad incheckningsåtgärd misslyckas initierar installationsprogrammet återställning men kan bara återställa de åtgärder som redan har skrivits till återställningsskriptet. Det innebär att en återställning kanske inte kan ångra ändringarna som gjorts av åtgärden beroende på den anpassade åtgärden. Du kan ignorera fel i incheckning av anpassade åtgärder genom att redigera den anpassade åtgärden för att ignorera returkoder.

När installationsprogrammet kör en anpassad återställningsåtgärd är den enda lägesparametern som anges MSIRUNMODE_ROLLBACK. En beskrivning av parametrarna för körningsläge finns i MsiGetMode.

En anpassad återställningsåtgärd kan anges genom att lägga till en alternativflagga i fältet Typ i tabellen CustomAction. Se anpassad åtgärd In-Script körningsalternativ för alternativflaggan som anger en anpassad återställningsåtgärd.

Återställning och incheckning av anpassade åtgärder körs inte när återställning är inaktiverad. Om en paketförfattare kräver dessa typer av anpassade åtgärder för korrekt installation bör de använda egenskapen RollbackDisabled i ett villkor som förhindrar att installationen fortsätter när återställningen är inaktiverad. Information om hur du inaktiverar återställning finns i Återställningsinstallation (Windows Installer).