Het gebruik van de Restart Manager met een primaire installer
In de volgende procedure wordt beschreven hoe u Restart Manager gebruikt om toepassingen en services af te sluiten en opnieuw te starten. Wanneer u De Manager opnieuw opstarten gebruikt met één installatieprogramma, is dit installatieprogramma ook het primaire installatieprogramma dat de gebruikersinterface beheert.
nl-NL: De Opnieuw Opstarten manager gebruiken met een primaire installer
Het installatieprogramma roept de RmStartSession--functie aan om de sessie Restart Manager te starten en een sessiehandgreep en -sleutel te verkrijgen.
Het installatieprogramma roept de functie RmRegisterResources aan om resources te registreren. De Manager voor opnieuw opstarten kan alleen geregistreerde resources gebruiken om te bepalen welke toepassingen en services moeten worden afgesloten en opnieuw moeten worden opgestart. Alle resources die kunnen worden beïnvloed door de installatie, moeten worden geregistreerd bij de sessie. Resources kunnen worden geïdentificeerd door bestandsnaam, korte servicenaam of een RM_UNIQUE_PROCESS structuur.
Het installatieprogramma roept de functie RmGetList aan om een matrix van RM_PROCESS_INFO structuren te verkrijgen waarin alle toepassingen en services worden vermeld die moeten worden afgesloten en opnieuw moeten worden opgestart.
Als de waarde van de parameter lpdwRebootReason die wordt geretourneerd door de functie RmGetList niet nul is, kan de Restart Manager geen geregistreerde resource vrij maken door een toepassing of service af te sluiten. In dit geval is een systeem afsluiten en opnieuw opstarten vereist om de installatie voort te zetten. Het installatieprogramma moet de gebruiker vragen om een actie, programma's of services stoppen of een systeem afsluiten en opnieuw opstarten plannen.
Als de waarde van de parameter lpdwRebootReason die wordt geretourneerd door de functie RmGetList nul is, moet het installatieprogramma de RmShutdown--functie aanroepen. Hiermee worden de services en toepassingen afgesloten die gebruikmaken van geregistreerde resources. Het installatieprogramma moet vervolgens systeemwijzigingen uitvoeren die nodig zijn om de installatie te voltooien. Ten slotte moet het installatieprogramma de RmRestart--functie aanroepen, zodat de functie Restart Manager de toepassingen die het programma heeft afgesloten opnieuw kan opstarten en die zijn geregistreerd voor opnieuw opstarten.
Het installatieprogramma kan de functie RmAddFilter gebruiken om te voorkomen dat opgegeven toepassingen en services worden afgesloten of opnieuw worden opgestart door Bewerkingen van Restart Manager. De functie RmGetFilterList retourneert een lijst met toepassingen en services die moeten worden gefilterd na afsluiten en opnieuw opstarten. Met de functie RmRemoveFilter wordt een filter verwijderd.
Het installatieprogramma roept de RmEndSession---functie aan om de Restart Manager-sessie te sluiten.
Zie Gebruik van Restart Manager met een secundair installatieprogrammavoor een voorbeeldcodefragment dat laat zien hoe je een Restart Manager sessie start en gebruikt met een primair installatieprogramma, en vervolgens een secundair installatieprogramma aan de bestaande sessie toevoegt.