Reihenfolge der Warteschlangenbindung
Wenn die SetupCommitFileQueue-Funktion die Dateiwarteschlange committet, verarbeitet sie die Dateivorgänge in der folgenden Reihenfolge: Dateilöschvorgänge, dann Dateiumbenennungsvorgänge und schließlich Dateikopiervorgänge. Die folgende Gliederung veranschaulicht den Lebenszyklus des Verpflichtungsprozesses einer Warteschlange.
- Starten der Löschunterabfrage
- Starten sie einen Dateilöschvorgang <– wiederholen Sie sie für jede Datei.
- Beenden eines Dateilöschvorgangs <– Löschen von Dateien in Warteschlange
- Beenden der Löschunterabfrage
- Starten der Unterabfrage "Umbenennen"
- Starten Sie einen Dateibenennungsvorgang <– wiederholen Sie für jeden Vorgang.
- Beenden eines Dateilöschvorgangs <– Dateibenennung in der Warteschlange
- Beenden der Umbenennungsunterabfrage
- Starten der Kopierunterabfrage
- Starten sie einen Dateikopiervorgang <– wiederholen Sie für jede Datei
- Beenden eines Dateikopiervorgangs <– Dateikopie in Warteschlange
- Fertigstellen der Kopierunterabfrage
- Beenden der Warteschlange
Bei jedem Schritt oder bei einem Fehler sendet die SetupCommitFileQueue-Funktion eine Benachrichtigung an die Rückrufroutine. Die Rückrufroutine kann die von der Warteschlange gesendeten Informationen verwenden, um den Installationsfortschritt nachzuverfolgen und bei Bedarf mit dem Benutzer zu interagieren.
Wenn beispielsweise für einen Dateikopiervorgang eine Quelldatei erforderlich ist, die im aktuellen Pfad nicht verfügbar war, sendet SetupCommitFileQueue eine SPFILENOTIFY_NEEDMEDIA Benachrichtigung an die Rückrufroutine sowie Informationen zu der erforderlichen Datei und den erforderlichen Medien. Die Rückrufroutine könnte diese Informationen verwenden, um ein Dialogfeld zu generieren, das den Benutzer auffordert, den nächsten Datenträger einzufügen, indem SetupPromptForDisk aufgerufen wird.
Eine Standardmäßige Warteschlangenrückrufroutine, SetupDefaultQueueCallback, ist in der Setup-API enthalten. Diese Routine verarbeitet Warteschlangenbenachrichtigungen und generiert Fehlerdialogfelder und Statusanzeigen für die Installation. Sie können die Standardmäßige Warteschlangenrückrufroutine verwenden oder eine Filterrückrufroutine schreiben, um eine Teilmenge der Benachrichtigungen zu verarbeiten und die anderen an die Standard-Warteschlangenrückrufroutine zu übergeben.
Wenn keine der Funktionen der Rückrufroutine Ihren Anforderungen entspricht, können Sie eine eigenständige benutzerdefinierte Rückrufroutine schreiben, die die Standardmäßige Warteschlangenrückrufroutine nicht aufruft.
Weitere Informationen zu Warteschlangenrückrufroutinen finden Sie unter Standardwarteschlangenrückrufroutine und Erstellen einer benutzerdefinierten Warteschlangenrückrufroutine.