Initialisieren und Beenden des Rückrufkontexts

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

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

Die SetupInitDefaultQueueCallbackEx-Funktion 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. Auf diese Weise können Sie die Standarddialogfelder für Die Eingabeaufforderung und Fehler des Datenträgers verwenden und auch eine Statusleiste in ein zweites Fenster einbetten, z. B. auf einer Seite eines Installations-Assistenten.

Rufen Sie setupTermDefaultQueueCallback auf, um die beim Initialisieren der Kontextstruktur zugeordneten Ressourcen frei zu geben, unabhängig davon, ob Sie den Kontext initialisiert haben, der von der Standardmäßig-Warteschlangenrückrufroutine mit SetupInitDefaultQueueCallback oder SetupInitDefaultQueueCallbackExverwendet wird.