messaggio SPFILENOTIFY_NEEDNEWCABINET
La notifica SPFILENOTIFY_NEEDNEWCABINET viene inviata da SetupIterateCabinet per indicare che il file corrente continua in un altro cabinet. La routine di callback può quindi chiamare SetupPromptForDisk o creare una finestra di dialogo personalizzata per richiedere all'utente di inserire il disco successivo.
SPFILENOTIFY_NEEDNEWCABINET
Param1 = (UINT) CabinetInfo;
Param2 = (UINT) NewPath;
Parametri
-
Param1
-
Puntatore a una struttura CABINET_INFO che contiene informazioni sull'archivio cab e sul file da estrarre.
-
Param2
-
Se il callback restituisce NO_ERROR, questo parametro è un puntatore a una stringa con terminazione Null. Se la stringa non è vuota, specifica un nuovo percorso per l'armadio.
Valore restituito
La routine deve restituire uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Non è stato rilevato alcun errore, continuare a elaborare l'armadio. |
|
Si è verificato un errore del tipo specificato. La funzione SetupIterateCabinet restituirà FALSE e il codice di errore specificato verrà restituito da una chiamata a GetLastError. |
Nota
Non esiste alcuna routine di callback cab predefinita; pertanto, è necessario fornire una routine di callback per gestire le notifiche inviate da SetupIterateCabinet.
Commenti
Se la routine di callback restituisce NO_ERROR, SetupIterateCabinet controlla il buffer a cui punta Param2. Se il buffer non è vuoto, contiene un nuovo percorso di origine. Se il buffer è vuoto, si presuppone che il percorso di origine sia invariato.
La funzione di callback deve garantire che il cabinet sia accessibile prima che venga restituito, chiamando la funzione SetupPromptForDisk , se è necessario inserire nuovi supporti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Intestazione |
|