Informazioni sulla routine di callback della coda predefinita

La routine di callback della coda predefinita gestisce le notifiche inviate da SetupCommitFileQueue in modo generico. Usando la routine predefinita, si ottiene un'interfaccia utente pronta per creare finestre di dialogo di installazione comuni. È consigliabile usare la routine di callback della coda predefinita, sia per semplificarne l'uso, sia per garantire coerenza nell'aspetto e nel comportamento delle finestre di dialogo generate durante l'installazione.

La routine di callback predefinita richiede una struttura di contesto per il mantenimento dei record interni. Inoltre, la coda passa informazioni aggiuntive rilevanti per la notifica corrente in un set di parametri, Param1 e Param2.

Ad esempio, se la coda invia una notifica di SPFILENOTIFY_NEEDMEDIA alla routine di callback predefinita, Param1 punta a una struttura SOURCE_MEDIA che contiene informazioni sui supporti richiesti e Param2 punta a una matrice di caratteri in grado di ricevere nuove informazioni sul percorso dall'utente.

La routine di callback predefinita usa queste informazioni per richiedere all'utente di inserire il supporto di origine necessario, specificare un nuovo percorso, ignorare la copia del file corrente o annullare l'operazione corrente. La routine di callback della coda predefinita restituisce FILEOP_NEWPATH, FILEOP_DOIT, FILEOP_SKIP o FILEOP_ABORT alla coda, a seconda dell'azione eseguita dall'utente.

Per informazioni su come la routine di callback della coda predefinita gestisce ogni notifica della coda, vedere notifiche delle code di file.

Per informazioni sulle routine di callback della coda personalizzate, vedere Creazione di una routine di callback della coda personalizzata.