SetupInitDefaultQueueCallbackEx-Funktion (setupapi.h)
[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]
Die SetupInitDefaultQueueCallbackEx-Funktion initialisiert den Kontext, der von der standardmäßigen Warteschlangenrückrufroutine verwendet wird, die in der Setup-API enthalten ist, auf die gleiche Weise wie SetupInitDefaultQueueCallback, mit der Ausnahme, dass der Rückruffunktion ein zusätzliches Fenster bereitgestellt wird, um Statusmeldungen zu akzeptieren.
Syntax
WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
[in] HWND OwnerWindow,
[in] HWND AlternateProgressWindow,
[in] UINT ProgressMessage,
[in] DWORD Reserved1,
[in] PVOID Reserved2
);
Parameter
[in] OwnerWindow
Handle mit dem Fenster, das als übergeordnetes Element aller Dialogfelder verwendet werden soll, die von der Standardrückrufroutine generiert wurden.
[in] AlternateProgressWindow
Handle mit einem Fenster, das die Statusmeldungen empfängt. Um zu verhindern, dass Statusmeldungen angezeigt werden, können Sie diesen Parameter angeben, um INVALID_HANDLE_VALUE zu werden.
[in] ProgressMessage
Nachricht, die beim Starten der Kopierwarteschlange und bei jedem Kopieren einer Datei an AlternateProgressWindow gesendet wird.
[in] Reserved1
Erster Nachrichtenparameter, der durch die Standardmäßige Rückrufroutine an die AlternateProgressWindow gesendet wird.
[in] Reserved2
Zweiter Nachrichtenparameter, der durch die Standardmäßige Rückrufroutine an die AlternateProgressWindow gesendet wird.
Rückgabewert
SetupInitDefaultQueueCallbackEx gibt einen Zeiger auf den Kontext zurück, der von der Standard-Warteschlangenrückrufroutine verwendet wird. Diese Funktion kann nur dann fehlschlagen, wenn nicht genügend Arbeitsspeicher vorhanden ist. Wenn diese Funktion fehlschlägt, gibt sie NULL zurück und legt nicht den letzten Fehlercode für den Thread fest.
Hinweise
Wenn die Warteschlange beginnt, die Kopierunterqueue zu commiten, sendet die Standardmäßige Warteschlangenrückrufroutine eine Nachricht an das in AlternateProgressWindow angegebene Fenster. Reserved1 hat den Wert 0, und Reserved2 enthält einen Zeiger auf die Anzahl der in die Warteschlange gestellten Dateikopiervorgänge.
Für jeden abgeschlossenen Dateikopievorgang sendet die Standardmäßige Warteschlangenrückrufroutine eine Nachricht an AlternateProgressWindow, die verwendet werden kann, um die Statusanzeige zu "aktivieren". Reserved1 hat den Wert 1 und Reserviert2 ist 0.
SetupInitDefaultQueueCallbackEx kann verwendet werden, um das Standardverhalten für Datenträgereingabeaufforderungen, Fehlerbehandlung usw. abzurufen und einen Messgerät bereitzustellen, der in eine Assistentenseite oder ein anderes spezialisiertes Dialogfeld eingebettet ist.
Unabhängig davon, ob Sie den Kontext initialisiert haben, der von der Standard-Warteschlangenrückrufroutine mit SetupInitDefaultQueueCallback oder SetupInitDefaultQueueCallbackEx verwendet wird, rufen Sie setupTermDefaultQueueCallback auf, um die beim Initialisieren der Kontextstruktur zugewiesenen Ressourcen freizugeben. Weitere Informationen finden Sie unter Initialisieren und Beenden des Rückrufkontexts.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | setupapi.h |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |
| APIs | ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393) |