SetupDefaultQueueCallbackA-Funktion (setupapi.h)

Artikel
11/20/2024

[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. 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 für die Installation von Gerätetreibern verwendet.]

Die SetupDefaultQueueCallback--Funktion ist die Standardrückrufroutine der Warteschlange, 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 wird.

[in] Notification

Benachrichtigung über eine Warteschlangenaktion. Dieser Parameter kann einer der werte sein, die in der folgenden Tabelle angezeigt werden.

Wert	Bedeutung
SPFILENOTIFY_STARTQUEUE	In die Warteschlange eingereihte Dateivorgänge gestartet.
SPFILENOTIFY_ENDQUEUE	Dateivorgänge in der Warteschlange wurden abgeschlossen.
SPFILENOTIFY_STARTSUBQUEUE	Eine Kopie, ein Umbenennen oder Löschen einer Unterabfrage wurde gestartet.
SPFILENOTIFY_ENDSUBQUEUE	Eine Kopie, ein Umbenennen oder löschen eine Unterabfrage abgeschlossen.
SPFILENOTIFY_STARTRENAME	Ein Umbenennungsvorgang wurde gestartet.
SPFILENOTIFY_ENDRENAME	Ein Umbenennungsvorgang wurde abgeschlossen.
SPFILENOTIFY_RENAMEERROR	Fehler beim Umbenennen einer Datei.
SPFILENOTIFY_STARTDELETE	Ein Löschvorgang wurde gestartet.
SPFILENOTIFY_ENDDELETE	Der Löschvorgang wurde abgeschlossen.
SPFILENOTIFY_DELETEERROR	Fehler beim Löschen einer Datei.
SPFILENOTIFY_STARTCOPY	Ein Kopiervorgang wurde gestartet.
SPFILENOTIFY_ENDCOPY	Ein Kopiervorgang wurde abgeschlossen.
SPFILENOTIFY_COPYERROR	Fehler beim Kopieren einer Datei.
SPFILENOTIFY_NEEDMEDIA	Neue Medien sind erforderlich.
SPFILENOTIFY_LANGMISMATCH	Vorhandene Zieldatei befindet sich in einer anderen Sprache als die Quelle.
SPFILENOTIFY_TARGETEXISTS	Die Zieldatei ist vorhanden.
SPFILENOTIFY_TARGETNEWER	Vorhandene Zieldatei ist neuer als 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 nicht signierte ganze Zahl an SetupCommitFileQueue zurück, die einer der in der folgenden Tabelle angezeigten Werte sein kann.

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

Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

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

Weitere Informationen finden Sie unter Warteschlangenbenachrichtigungen.

Anmerkung

Der header setupapi.h 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

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	setupapi.h
Library	Setupapi.lib
DLL-	Setupapi.dll
API-Satz	ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Funktionen

Übersicht

SetupCommitFileQueue

Freigeben über