SetupOpenFileQueue-Funktion (setupapi.h)

Artikel
03/04/2024

[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 SetupOpenFileQueue-Funktion erstellt eine Setupdateiwarteschlange.

Syntax

WINSETUPAPI HSPFILEQ SetupOpenFileQueue();

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein Handle an eine Setupdateiwarteschlange zurückgegeben. Wenn nicht genügend Arbeitsspeicher zum Erstellen der Warteschlange vorhanden ist, gibt die Funktion INVALID_HANDLE_VALUE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Nachdem ein Commit für die Dateiwarteschlange ausgeführt wurde und nicht mehr benötigt wird, sollte SetupCloseFileQueue aufgerufen werden, um die während setupOpenFileQueue zugeordneten Ressourcen freizugeben.

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