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

Siehe auch

Funktionen

Übersicht

SetupInitDefaultQueueCallback