Spfilenotify _ neednewcab-Nachricht

Die spfilenotify _ neednewcab -Benachrichtigung wird von setupiteratecabinet gesendet, um anzugeben, dass die aktuelle Datei in einer anderen CAB-Datei fortgesetzt wird. Die Rückruf Routine kann dann setuppromptfordiskaufrufen oder ein eigenes Dialogfeld erstellen, in dem der Benutzer aufgefordert wird, den nächsten Datenträger einzufügen.

SPFILENOTIFY_NEEDNEWCABINET
  Param1 = (UINT) CabinetInfo;
  Param2 = (UINT) NewPath;
            

Parameter

Param1

Ein Zeiger auf eine CAB -Informationsstruktur _ , die Informationen über die CAB-Datei und die zu extrahierende Datei enthält.

Param2

Wenn der Rückruf keinen Fehler zurückgibt _ , ist dieser Parameter ein Zeiger auf eine NULL-terminierte Zeichenfolge. Wenn die Zeichenfolge nicht leer ist, wird ein neuer Pfad zur CAB-Datei angegeben.

Rückgabewert

Die Routine sollte einen der folgenden Werte zurückgeben.

Rückgabecode Beschreibung
kein _ Fehler
Es wurde kein Fehler gefunden. setzen Sie die Verarbeitung der CAB-
*Fehler _ XXX * * *
Ein Fehler des angegebenen Typs ist aufgetreten. Die setupiteratecabinet -Funktion gibt " false" zurück, und der angegebene Fehlercode wird durch einen get-Befehl von " GetLastError" zurückgegeben.

Hinweis

Es ist keine standardmäßige CAB-Rückruf Routine vorhanden. Daher müssen Sie eine Rückruf Routine bereitstellen, um die von setupiteratecabinetgesendeten Benachrichtigungen zu verarbeiten.

Bemerkungen

Wenn die Rückruf Routine keinen Fehler zurückgibt _ , prüft setupiteratecabinet den Puffer, auf den von Param2 verwiesen wird. Wenn der Puffer nicht leer ist, enthält er einen neuen Quellpfad. Wenn der Puffer leer ist, wird davon ausgegangen, dass der Quellpfad unverändert ist.

Die Rückruffunktion sollte sicherstellen, dass auf die CAB-Datei zugegriffen werden kann, bevor Sie zurückkehrt, und die Funktion setuppromptfordisk aufrufen, wenn neue Medien eingefügt werden müssen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Nur Windows XP [ -Desktop-Apps]
Unterstützte Mindestversion (Server)
Nur Windows Server 2003 [ -Desktop-Apps]
Header
Setupapi. h

Weitere Informationen

Übersicht

Benachrichtigungen

CAB- _ Informationen

Setupiteratecabinet