Reihenfolge der Warteschlangenbindung
Wenn die SetupCommitFileQueue-Funktion die Dateiwarteschlange commits, verarbeitet sie die Dateivorgänge in der folgenden Reihenfolge: Dateilöschvorgänge, dann Dateiumbenennungsvorgänge und schließlich Dateikopien. Die folgende Gliederung veranschaulicht den Lebenszyklus des Verpflichtungsprozesses einer Warteschlange.
- Starten der Löschunterabfrage
- Starten eines Dateilöschvorgangs <– wiederholen Sie diesen Vorgang für jede Datei.
- Beenden eines Dateilöschvorgangs <– Löschvorgang in der Warteschlange
- Beenden der Löschunterabfrage
- Starten der Umbenennungsunterabfrage
- Starten sie einen Dateibenennungsvorgang <– wiederholen Sie diesen Vorgang für jede Datei.
- Beenden eines Dateilöschvorgangs <– Dateibebenennung in der Warteschlange
- Beenden der Umbenennungsunterabfrage
- Kopieren unterque starten
- Starten eines Dateikopievorgangs <– wiederholen Sie diesen Vorgang für jede Datei.
- Beenden eines Dateikopievorgangs <– In die Warteschlange eingereihte Dateikopie
- Beenden der Kopie-Unterabfrage
- Beenden der Warteschlange
Bei jedem Schritt oder wenn ein Fehler auftritt, 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 ggf. mit dem Benutzer zu interagieren.
Wenn beispielsweise ein Dateikopievorgang eine Quelldatei benötigt hat, die nicht im aktuellen Pfad verfügbar war, SetupCommitFileQueue eine SPFILENOTIFY_NEEDMEDIA Benachrichtigung an die Rückrufroutine sowie Informationen zu der erforderlichen Datei und medien senden würde. Die Rückrufroutine kann diese Informationen verwenden, um ein Dialogfeld zu generieren, in dem der Benutzer aufgefordert wird, den nächsten Datenträger einzufügen, indem SetupPromptForDisk-
Eine Standardmäßige Rückrufroutine in der Warteschlange, SetupDefaultQueueCallback, ist in der Setup-API enthalten. Diese Routine behandelt Warteschlangenbenachrichtigungen und generiert Fehlerdialogfelder und Statusindikatoren für die Installation. Sie können die Standardrückrufroutine in der Warteschlange verwenden oder eine Filterrückrufroutine schreiben, um eine Teilmenge der Benachrichtigungen zu verarbeiten und die anderen an die Standardrückrufroutine der Warteschlange weiterzuverschieben.
Wenn keiner der Funktionen der Rückrufroutine Ihren Anforderungen entspricht, können Sie eine eigenständige benutzerdefinierte Rückrufroutine schreiben, die nicht die Standardrückrufroutine der Warteschlange aufruft.
Weitere Informationen zu Warteschlangenrückrufroutinen finden Sie unter Standard-Warteschlangenrückrufroutineund Erstellen einer benutzerdefinierten Warteschlangenrückrufroutine.