SPFILENOTIFY_NEEDNEWCABINET Nachricht
Die SPFILENOTIFY_NEEDNEWCABINET Benachrichtigung wird von SetupIterateCabinet gesendet, um anzugeben, dass die aktuelle Datei in einer anderen Ablage fortgesetzt wird. Ihre Rückrufroutine kann dann SetupPromptForDisk aufrufen oder ein eigenes Dialogfeld erstellen, um den Benutzer aufzufordern, den nächsten Datenträger einzufügen.
SPFILENOTIFY_NEEDNEWCABINET
Param1 = (UINT) CabinetInfo;
Param2 = (UINT) NewPath;
Parameter
-
Param1
-
Zeiger auf eine CABINET_INFO Struktur, die Informationen zur Ablage und der zu extrahierenden Datei enthält.
-
Param2
-
Wenn der Rückruf NO_ERROR zurückgibt, ist dieser Parameter ein Zeiger auf eine Zeichenfolge mit NULL-Beendigung. Wenn die Zeichenfolge nicht leer ist, wird ein neuer Pfad zur Ablage angegeben.
Rückgabewert
Ihre Routine sollte einen der folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Es ist kein Fehler aufgetreten. Fahren Sie mit der Verarbeitung der Ablage fort. |
|
Ein Fehler des angegebenen Typs ist aufgetreten. Die SetupIterateCabinet-Funktion gibt FALSE zurück, und der angegebene Fehlercode wird durch einen Aufruf von GetLastError zurückgegeben. |
Hinweis
Es gibt keine standardmäßige Ablagerückrufroutine. Daher müssen Sie eine Rückrufroutine bereitstellen, um die von SetupIterateCabinet gesendeten Benachrichtigungen zu verarbeiten.
Bemerkungen
Wenn die Rückrufroutine NO_ERROR zurückgibt, überprüft SetupIterateCabinet den Puffer, auf den Param2 verweist. 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.
Ihre Rückruffunktion sollte sicherstellen, dass auf die Ablage zugegriffen werden kann, bevor sie zurückgegeben wird, indem die Funktion SetupPromptForDisk aufgerufen wird, wenn neue Medien eingefügt werden müssen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|