SetupIterateCabinetA-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 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 SetupIterateCabinet-Funktion durchläuft alle Dateien in einer Ablage und sendet eine Benachrichtigung an eine Rückruffunktion für jede gefundene Datei.

Syntax

WINSETUPAPI BOOL SetupIterateCabinetA(
  [in] PCSTR               CabinetFile,
  [in] DWORD               Reserved,
  [in] PSP_FILE_CALLBACK_A MsgHandler,
  [in] PVOID               Context
);

Parameter

[in] CabinetFile

Zu durchlaufende Cabinet-Datei (.CAB).

[in] Reserved

Derzeit nicht verwendet.

[in] MsgHandler

Zeiger auf eine FileCallback-Routine , die die von SetupIterateCabinet zurückgegebenen Benachrichtigungen verarbeitet, während die Dateien in der Ablagedatei durchlaufen werden. Die Rückrufroutine gibt dann möglicherweise einen Wert zurück, der angibt, ob die Datei dekomprimieren, kopiert oder übersprungen werden soll.

[in] Context

Kontextwert, der an die in MsgHandler angegebene Routine übergeben wird. Dadurch kann die Rückrufroutine Werte zwischen Benachrichtigungen nachverfolgen, ohne globale Variablen verwenden zu müssen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der Setupapi.h-Header definiert SetupIterateCabinet 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
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