SetupDefaultQueueCallbackA-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 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 SetupDefaultQueueCallback-Funktion ist die Standard-Warteschlangenrückrufroutine, die in der Setup-API enthalten ist. Sie können es verwenden, um Benachrichtigungen zu verarbeiten, die von der SetupCommitFileQueue-Funktion gesendet werden.

Syntax

WINSETUPAPI UINT SetupDefaultQueueCallbackA(
  [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 wurde.

[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 wurden gestartet.
SPFILENOTIFY_ENDQUEUE
 Abgeschlossene Dateivorgänge in der Warteschlange.
SPFILENOTIFY_STARTSUBQUEUE
 Es wurde ein Kopieren, Umbenennen oder Löschen einer Unterqueue gestartet.
SPFILENOTIFY_ENDSUBQUEUE
 Das Kopieren, Umbenennen oder Löschen einer Unterqueue wurde abgeschlossen.
SPFILENOTIFY_STARTRENAME
 Hat einen Umbenennungsvorgang gestartet.
SPFILENOTIFY_ENDRENAME
 Ein Umbenennungsvorgang wurde abgeschlossen.
SPFILENOTIFY_RENAMEERROR
 Beim Umbenennen einer Datei ist ein Fehler aufgetreten.
SPFILENOTIFY_STARTDELETE
 Es wurde ein Löschvorgang gestartet.
SPFILENOTIFY_ENDDELETE
 Ein Löschvorgang wurde abgeschlossen.
SPFILENOTIFY_DELETEERROR
 Beim Löschen einer Datei ist ein Fehler aufgetreten.
SPFILENOTIFY_STARTCOPY
 Es wurde ein Kopiervorgang gestartet.
SPFILENOTIFY_ENDCOPY
 Ein Kopiervorgang wurde abgeschlossen.
SPFILENOTIFY_COPYERROR
 Beim Kopieren einer Datei ist ein Fehler aufgetreten.
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 Benachrichtigungsparameters ab.

[in] Param2

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

Rückgabewert

Gibt eine ganze Zahl ohne Vorzeichen an SetupCommitFileQueue zurück, die einer der Werte sein kann, die in der folgenden Tabelle dargestellt sind.

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 normalerweise 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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
APIs ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Funktionen

Übersicht

SetupCommitFileQueue