Initialisieren und Beenden des Rückrufkontexts

Bevor die Standardmäßige Warteschlangenrückrufroutine verwendet werden kann, muss sie entweder durch Angabe als Rückrufroutine beim Committen einer Dateiwarteschlange oder durch Aufrufen aus einer benutzerdefinierten Rückrufroutine initialisiert werden.

Die SetupInitDefaultQueueCallback-Funktion erstellt die Kontextstruktur, die von der standardmäßigen Warteschlangenrückrufroutine verwendet wird. Er gibt einen void-Zeiger auf diese Struktur zurück. Diese Struktur ist für den Vorgang der Standardrückrufroutine unerlässlich und muss an die Rückrufroutine übergeben werden. Dazu geben Sie entweder den void-Zeiger als Kontext in einem Aufruf von SetupCommitFileQueue an, oder indem Sie den void-Zeiger als Kontextparameter angeben, wenn SetupDefaultQueueCallback aus einer benutzerdefinierten Rückrufroutine aufgerufen wird. Diese Kontextstruktur darf von der Setupanwendung nicht geändert oder referenziert werden.

Die Funktion SetupInitDefaultQueueCallbackEx initialisiert auch einen Kontext für die Standardmäßige Warteschlangenrückrufroutine, gibt jedoch ein zweites Fenster an, in dem jedes Mal, wenn die Warteschlange eine Benachrichtigung sendet, eine vom Aufrufer angegebene Statusmeldung empfangen wird. Dadurch können Sie die Standarddialogfelder für Datenträgereingabeaufforderungen und Fehler verwenden und auch eine Statusanzeige in ein zweites Fenster einbetten, z. B. auf einer Seite eines Installations-Assistenten.

Unabhängig davon, ob Sie den Kontext initialisiert haben, der von der Standardmäßigen Warteschlangenrückrufroutine mit SetupInitDefaultQueueCallback oder SetupInitDefaultQueueCallbackEx verwendet wird, rufen Sie setupTermDefaultQueueCallback auf, um die beim Initialisieren der Kontextstruktur zugeordneten Ressourcen freizugeben.