Informationen zur Standardwarteschlangenrückrufroutine
Die Standardmäßige Warteschlangenrückrufroutine verarbeitet Benachrichtigungen, die von SetupCommitFileQueue gesendet werden, auf generische Weise. Mithilfe der Standardroutine erhalten Sie eine fertige Benutzeroberfläche, um allgemeine Setupdialogfelder zu erstellen. Es wird empfohlen, die Standardmäßige Warteschlangenrückrufroutine zu verwenden, sowohl aus Gründen der Benutzerfreundlichkeit als auch, um eine konsistente Darstellung und ein konsistentes Verhalten der während der Installation generierten Dialogfelder sicherzustellen.
Die Standardrückrufroutine erfordert eine Kontextstruktur für die interne Aufbewahrung von Datensätzen. Darüber hinaus übergibt die Warteschlange zusätzliche Informationen, die für die aktuelle Benachrichtigung relevant sind, in einer Reihe von Parametern , Param1 und Param2.
Wenn die Warteschlange beispielsweise eine SPFILENOTIFY_NEEDMEDIA Benachrichtigung an die Standardrückrufroutine sendet, verweist Param1 auf eine SOURCE_MEDIA-Struktur , die Informationen zu den benötigten Medien enthält, und Param2 verweist auf ein Zeichenarray, das neue Pfadinformationen vom Benutzer empfangen kann.
Die Standardrückrufroutine verwendet diese Informationen, um den Benutzer aufzufordern, entweder die erforderlichen Quellmedien einzufügen, einen neuen Pfad anzugeben, das Kopieren der aktuellen Datei zu überspringen oder den aktuellen Vorgang abzubrechen. Die Standardmäßige Warteschlangenrückrufroutine gibt FILEOP_NEWPATH, FILEOP_DOIT, FILEOP_SKIP oder FILEOP_ABORT an die Warteschlange zurück, je nachdem, welche Aktion der Benutzer ausgeführt hat.
Informationen dazu, wie die Standardmäßige Warteschlangenrückrufroutine jede Warteschlangenbenachrichtigung verarbeitet, finden Sie unter Dateiwarteschlangenbenachrichtigungen.
Informationen zu benutzerdefinierten Warteschlangenrückrufroutinen finden Sie unter Erstellen einer benutzerdefinierten Warteschlangenrückrufroutine.