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

Siehe auch

Funktionen

Übersicht

SetupDefaultQueueCallback

SetupInitDefaultQueueCallbackEx