Share via

SetupDefaultQueueCallbackW-Funktion (setupapi.h)

  • Artikel

[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 Funktion SetupDefaultQueueCallback ist die Standardmäßige Warteschlangenrückrufroutine, die in der Setup-API enthalten ist. Sie können damit Benachrichtigungen verarbeiten, die von der SetupCommitFileQueue-Funktion gesendet werden.

Syntax

WINSETUPAPI UINT SetupDefaultQueueCallbackW(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

Parameter

[in] Context

Zeiger auf den Kontext, der von den Funktionen SetupInitDefaultQueueCallback oder SetupInitDefaultQueueCallbackEx initialisiert wird.

[in] Notification

Benachrichtigung über eine Warteschlangenaktion. Für diesen Parameter kann einer der Werte in der folgenden Tabelle angegeben werden.

Wert Bedeutung
SPFILENOTIFY_STARTQUEUE
 Dateivorgänge in der Warteschlange gestartet.
SPFILENOTIFY_ENDQUEUE
 Abgeschlossene Dateivorgänge in der Warteschlange.
SPFILENOTIFY_STARTSUBQUEUE
 Es wurde eine Unterabfrage zum Kopieren, Umbenennen oder Löschen gestartet.
SPFILENOTIFY_ENDSUBQUEUE
 Das Kopieren, Umbenennen oder Löschen einer Unterwarteschlange wurde abgeschlossen.
SPFILENOTIFY_STARTRENAME
 Ein Umbenennungsvorgang wurde gestartet.
SPFILENOTIFY_ENDRENAME
 Ein Umbenennungsvorgang wurde abgeschlossen.
SPFILENOTIFY_RENAMEERROR
 Fehler beim Umbenennen einer Datei.
SPFILENOTIFY_STARTDELETE
 Es wurde ein Löschvorgang gestartet.
SPFILENOTIFY_ENDDELETE
 Löschvorgang abgeschlossen.
SPFILENOTIFY_DELETEERROR
 Fehler beim Löschen einer Datei.
SPFILENOTIFY_STARTCOPY
 Es wurde ein Kopiervorgang gestartet.
SPFILENOTIFY_ENDCOPY
 Ein Kopiervorgang wurde abgeschlossen.
SPFILENOTIFY_COPYERROR
 Fehler beim Kopieren einer Datei.
SPFILENOTIFY_NEEDMEDIA
 Neue Medien sind erforderlich.
SPFILENOTIFY_LANGMISMATCH
 Die vorhandene Zieldatei hat eine andere Sprache als die Quelle.
SPFILENOTIFY_TARGETEXISTS
 Die Zieldatei ist vorhanden.
SPFILENOTIFY_TARGETNEWER
Die vorhandene Zieldatei ist neuer als die Quelle.

[in] Param1

Zusätzliche Nachrichteninformationen. Der Inhalt dieses Parameters hängt vom Wert des Notification-Parameters ab.

[in] Param2

Zusätzliche Nachrichteninformationen. Der Inhalt dieses Parameters hängt vom Wert des Notification-Parameters ab.

Rückgabewert

Gibt eine ganze Zahl ohne Vorzeichen an SetupCommitFileQueue zurück, bei der es sich um den in der folgenden Tabelle gezeigten Werten handeln kann.

Rückgabecode Beschreibung
FILEOP_ABORT
 Bricht den Vorgang ab.
FILEOP_DOIT
 Führt den Dateivorgang aus.
FILEOP_SKIP
 Überspringt den Vorgang.
FILEOP_RETRY
 Wiederholt den Vorgang.
FILEOP_NEWPATH
 Ruft einen neuen Pfad für den Vorgang ab.
 

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die SetupDefaultQueueCallback-Funktion wird in der Regel nur explizit von einer benutzerdefinierten Warteschlangenrückrufroutine aufgerufen. Der benutzerdefinierte Rückruf verarbeitet eine Teilmenge der Warteschlangencommitbenachrichtigungen und ruft die SetupDefaultQueueCallback-Funktion auf, um die restlichen Benachrichtigungen zu verarbeiten.

Weitere Informationen finden Sie unter Warteschlangenbenachrichtigungen.

Hinweis

Der Setupapi.h-Header definiert SetupDefaultQueueCallback als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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)

Siehe auch

Funktionen

Übersicht

SetupCommitFileQueue