SetupDefaultQueueCallbackA-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 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