Notifiche (API di installazione)

Le notifiche sono valori che una funzione di installazione invia a una routine di callback per specificare uno stato o un evento. Due parametri, Param1 e Param2, vengono inviati con la notifica e contengono informazioni aggiuntive rilevanti per la notifica.

La routine di callback elabora la notifica e restituisce un intero senza segno alla funzione di installazione. A seconda della funzione di installazione, è possibile usare questo valore per specificare un'operazione o una selezione utente oppure ignorarla.

Le funzioni di installazione inviano notifiche alle routine di callback usando la sintassi seguente.

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //notification code
    Param1,          //additional notification information
    Param2           //additional notification information
);

Il parametro Context è un puntatore void a una variabile di contesto o a una struttura che la routine di callback può usare per archiviare informazioni che devono essere persistenti tra le chiamate successive alla routine di callback.

Poiché la routine di callback specifica l'implementazione del contesto e non viene mai fatto riferimento o modificato dalle funzioni di installazione, il contesto non è documentato nel materiale di riferimento per i messaggi di notifica che seguono.

Il parametro Notifica specifica un valore intero senza segno per un evento o uno stato che causa la funzione di installazione di chiamare la routine di callback.

Param1 e Param2 sono parametri facoltativi che possono contenere informazioni aggiuntive pertinenti alla notifica. Questi parametri sono interi senza segno. Se Param1 o Param2 restituiscono informazioni che non sono un intero senza segno, viene eseguito il cast in un intero senza segno e deve essere ricastato nel tipo di dati originale prima che possa essere usato dalla routine di callback.

Nota

Le notifiche seguenti rappresentano ogni notifica usata dalle funzioni di installazione. Le singole funzioni usano un subset di queste notifiche. In altre parole, non ogni notifica viene usata da ogni funzione.

 

Le notifiche seguenti vengono usate dalle funzioni di installazione.

Notifica	Descrizione
SPFILENOTIFY_COPYERROR	Errore durante un'operazione di copia file.
SPFILENOTIFY_DELETEERROR	Errore durante un'operazione di eliminazione dei file.
SPFILENOTIFY_ENDCOPY	È stata terminata un'operazione di copia file.
SPFILENOTIFY_ENDDELETE	È stata terminata un'operazione di eliminazione file.
SPFILENOTIFY_ENDQUEUE	La coda ha completato il commit.
SPFILENOTIFY_ENDREGISTRATION	La registrazione o l'annullamento della registrazione del file è stata completata.
SPFILENOTIFY_ENDRENAME	È stata terminata un'operazione di ridenominazione del file.
SPFILENOTIFY_ENDSUBQUEUE	È stata terminata una sottoqueue (copia, rinominare o eliminare).
SPFILENOTIFY_FILEEXTRACTED	Il file è stato estratto dal gabinetto.
SPFILENOTIFY_FILEINCABINET	Viene rilevato un file nel gabinetto.
SPFILENOTIFY_FILEOPDELAYED	Il file è in uso e l'operazione corrente è stata ritardata fino al riavvio del sistema.
SPFILENOTIFY_LANGMISMATCH	La lingua dell'operazione corrente non corrisponde alla lingua di sistema.
SPFILENOTIFY_NEEDMEDIA	È necessario un nuovo supporto di origine.
SPFILENOTIFY_NEEDNEWCABINET	Il file corrente viene continuato nel successivo gabinetto.
SPFILENOTIFY_QUEUESCAN	È stato analizzato un nodo nella coda di file.
SPFILENOTIFY_QUEUESCAN_EX	È stato analizzato un nodo nella coda di file.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO	È stato analizzato un nodo nella coda di file.
SPFILENOTIFY_RENAMEERROR	Si è verificato un errore durante un'operazione di ridenominazione del file.
SPFILENOTIFY_STARTCOPY	È stata avviata un'operazione di copia file.
SPFILENOTIFY_STARTDELETE	È stata avviata un'operazione di eliminazione file.
SPFILENOTIFY_STARTQUEUE	La coda ha iniziato a eseguire il commit.
SPFILENOTIFY_STARTREGISTRATION	La registrazione o l'annullamento della registrazione del file è stata avviata.
SPFILENOTIFY_STARTRENAME	È stata avviata un'operazione di ridenominazione file.
SPFILENOTIFY_STARTSUBQUEUE	È stata avviata una sottoqueue (copia, rinominare o eliminare).
SPFILENOTIFY_TARGETEXISTS	Una copia del file specificato esiste già nella destinazione.
SPFILENOTIFY_TARGETNEWER	Nella destinazione esiste una versione più recente del file specificato.