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

Anforderungen

Siehe auch

Funktionen

Übersicht