Inizializzazione e terminazione del contesto di callback

Prima di poter utilizzare la routine di callback della coda predefinita, specificandola come routine di callback durante il commit di una coda di file o chiamandola da una routine di callback personalizzata, deve essere inizializzata.

La funzione SetupInitDefaultQueueCallback costruisce la struttura del contesto utilizzata dalla routine di callback della coda predefinita. Restituisce un puntatore void a tale struttura. Questa struttura è essenziale per l'operazione della routine di callback predefinita e deve essere passata alla routine di callback. A tale scopo, è possibile specificare il puntatore void come contesto in una chiamata a SetupCommitFileQueueoppure specificando il puntatore void come parametro di contesto quando si chiama SetupDefaultQueueCallback da una routine di callback personalizzata. Questa struttura di contesto non deve essere modificata né referenziata dall'applicazione di installazione.

La funzione SetupInitDefaultQueueCallbackEx inizializza anche un contesto per la routine di callback della coda predefinita, ma specifica una seconda finestra per ricevere un messaggio di stato specificato dal chiamante ogni volta che la coda invia una notifica. In questo modo è possibile usare le finestre di dialogo predefinite di richiesta e errore del disco e di incorporare anche una barra di stato in una seconda finestra, ad esempio, in una pagina di un'installazione guidata.

Indipendentemente dal fatto che tu abbia inizializzato il contesto utilizzato dalla routine di callback della coda predefinita con SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx, dopo che le operazioni in coda hanno terminato l'elaborazione, chiama SetupTermDefaultQueueCallback per rilasciare le risorse allocate durante l'inizializzazione della struttura del contesto.