SetupCommitFileQueueW-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 SetupCommitFileQueue-Funktion führt Dateivorgänge aus, die in einer Setupdateiwarteschlange in die Warteschlange eingereiht werden.
Die bewährte Methode besteht darin, alle erforderlichen Dateivorgänge für die Dateiwarteschlange zu sammeln und die Warteschlange nur einmal zu committen, da eine Dateiwarteschlange nach dem Commit nicht wiederverwendet werden kann. Wenn nach dem Commit eine zusätzliche Verarbeitung der Warteschlange erforderlich ist, sollte das Handle für die Warteschlange geschlossen und eine neue Dateiwarteschlange erstellt werden. Weitere Informationen finden Sie unter Commitieren einer Warteschlange.
Wenn eine Datei geändert wird, muss der Aufrufer dieser Funktion über Berechtigungen zum Schreiben in das Zielverzeichnis verfügen.
Syntax
WINSETUPAPI BOOL SetupCommitFileQueueW(
[in] HWND Owner,
[in] HSPFILEQ QueueHandle,
[in] PSP_FILE_CALLBACK_W MsgHandler,
[in] PVOID Context
);
Parameter
[in] Owner
Optionales Handle für ein Fenster, das als übergeordnetes Element aller Statusdialogfelder verwendet werden soll.
[in] QueueHandle
Behandeln Sie eine Setupdateiwarteschlange, wie sie von SetupOpenFileQueue zurückgegeben wird.
[in] MsgHandler
Zeiger auf eine optionale Rückrufroutine, um über verschiedene wichtige Ereignisse benachrichtigt zu werden, die sich in der Warteschlangenverarbeitung befinden. Weitere Informationen finden Sie unter Standardwarteschlangenrückrufroutine oder Dateirückruf Wenn die Rückrufroutine NULL ist, gibt SetupCommitFileQueueTRUE zurück, und der Fehler ist 0 oder NO_ERROR.
[in] Context
Wert, der an die Rückruffunktion übergeben wird, die vom MsgHandler-Parameter bereitgestellt wird. Wenn die Standardrückrufroutine als MsgHandler angegeben wurde, muss dieser Kontext der kontext sein, der von SetupInitDefaultQueueCallback oder SetupInitDefaultQueueCallbackEx zurückgegeben wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die in MsgHandler angegebene Rückrufroutine sollte mit den Parametern kompatibel sein, die SetupCommitFileQueue während eines Warteschlangencommitqueue-Commits an sie übergeben hat.
Wenn Unicode in Ihrer Rückrufanwendung definiert ist und Sie MsgHandler als Standard-Warteschlangenrückrufroutine angeben, erwartet die Rückrufroutine Unicode-Parameter. Andernfalls erwartet die Standardmäßige Warteschlangenrückrufroutine ANSI-Parameter.
Hinweis
Der setupapi.h-Header definiert SetupCommitFileQueue 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 |
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für