Verwenden des Neustart-Managers mit einer externen Benutzeroberfläche

Windows Installer-Entwickler können ihr Installationspaket für die Arbeit mit dem Neustart-Manager vorbereiten, indem sie die unter Verwenden von Windows Installer mit dem Neustart-Manager beschriebenen Leitlinien befolgen.

Geben Sie den Meldungstyp INSTALLLOGMODE_RMFILESINUSE an, wenn Sie die Funktion MsiSetExternalUI oder MsiSetExternalUIRecord aufrufen, um den Handler für die externe Benutzeroberfläche zu aktivieren. Windows Installer sendet dann eine INSTALLMESSAGE_RMFILESINUSE-Meldung zur Verwendung durch Handler für externe Benutzeroberflächen, die den Neustart-Manager unterstützen.

Ihr Handler für externe Benutzeroberflächen muss die in INSTALLMESSAGE_RMFILESINUSE-Meldungen enthaltenen Informationen verarbeiten. Wenn keine registrierte oder interne Benutzeroberfläche die INSTALLMESSAGE_RMFILESINUSE-Meldung verarbeitet, sendet Windows Installer eine INSTALLMESSAGE_FILESINUSE-Meldung zur Verwendung durch vorhandene externe Handler, die INSTALLMESSAGE_FILESINUSE-Meldungen und das Dialogfeld FilesInUse unterstützen.

Diese externe Benutzeroberfläche kann die in der folgenden Tabelle aufgeführten Werte zurückgeben.

Rückgabewert der externen Benutzeroberfläche Von Windows Installer ausgeführte Aktion
IDOK Der Benutzer hat auf die Schaltfläche OK geklickt. Der Windows Installer verlangt, dass der Neustart-Manager die Anwendungen, die derzeit verwendete Dateien enthalten, herunterfährt und neu startet.
IDCANCEL Es wurde auf die Schaltfläche ABBRECHEN geklickt. Brechen Sie die Installation ab.
IDIGNORE Es wurde auf die Schaltfläche IGNORIEREN geklickt. Ignorieren Sie die Installation, und setzen Sie sie fort. Am Ende der Installation ist ein Neustart erforderlich.
IDNO Es wurde auf die Schaltfläche NEIN geklickt. Wenn das Paket über ein MsiRMFilesInUse-Dialogfeld verfügt, senden Sie eine 1610-Meldung. Weitere Informationen finden Sie unter Windows Installer-Fehlermeldungen. Wenn das Paket kein MsiRMFilesInUse-Dialogfeld enthält, senden Sie eine INSTALLMESSAGE_FILESINUSE-Meldung.
IDRETRY Es wurde auf die Schaltfläche WIEDERHOLEN geklickt. Senden Sie die INSTALLMESSAGE_FILESINUSE-Meldung.
-1 Ein Fehler. Beenden Sie die Installation.