SetupIterateCabinetW-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 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 SetupIterateCabinetW(
  [in] PCWSTR              CabinetFile,
  [in] DWORD               Reserved,
  [in] PSP_FILE_CALLBACK_W MsgHandler,
  [in] PVOID               Context
);

Parameter

[in] CabinetFile

Ablagedatei (.CAB) zum Durchlaufen.

[in] Reserved

Derzeit nicht verwendet.

[in] MsgHandler

Zeiger auf eine FileCallback-Routine , die die Benachrichtigungen verarbeitet, die SetupIterateCabinet zurückgibt, während sie die Dateien in der Ablagedatei durchlaufen. 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 Nichtzero-Wert.

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