SetupInitDefaultQueueCallback-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 zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]
Die SetupInitDefaultQueueCallback-Funktion initialisiert den Kontext, der von der standardmäßigen Warteschlangenrückrufroutine verwendet wird, die in der Setup-API enthalten ist.
Syntax
WINSETUPAPI PVOID SetupInitDefaultQueueCallback(
[in] HWND OwnerWindow
);
Parameter
[in] OwnerWindow
Handle für das Fenster, das als übergeordnetes Element aller Dialogfelder verwendet werden soll, die von der Standardrückrufroutine generiert werden.
Rückgabewert
Zeiger auf den Kontext, der von der standardmäßigen Warteschlangenrückrufroutine verwendet wird.
Wenn der Aufruf von SetupInitDefaultQueueCallback fehlschlägt, gibt die Funktion den PVOID-Wert NULL zurück.
Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
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. Weitere Informationen finden Sie unter Initialisieren und Beenden des Rückrufkontexts.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |