Condividi tramite

Notifiche (API di installazione)

  • Articolo

Le notifiche sono valori inviati da una funzione di installazione 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 dell'utente oppure ignorarlo.

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 o struttura di contesto che la routine di callback può usare per archiviare informazioni che devono essere mantenute 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 Notification specifica un valore intero senza segno per un evento o uno stato che fa sì che la funzione di installazione chiami la routine di callback.

Param1 e Param2 sono parametri facoltativi che possono contenere informazioni aggiuntive rilevanti per la notifica. Questi parametri sono numeri interi senza segno. Se Param1 o Param2 restituiscono informazioni che non sono un intero senza segno, viene eseguito il cast a un intero senza segno e deve essere recastato al tipo di dati originale prima che possa essere utilizzato 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 tutte le notifiche vengono usate da ogni funzione.

 

Le notifiche seguenti vengono usate dalle funzioni di installazione.

Notifica Descrizione
SPFILENOTIFY_COPYERROR Si è verificato un errore durante un'operazione di copia file.
SPFILENOTIFY_DELETEERROR Si è verificato un errore durante un'operazione di eliminazione di file.
SPFILENOTIFY_ENDCOPY Un'operazione di copia file è terminata.
SPFILENOTIFY_ENDDELETE Un'operazione di eliminazione file è terminata.
SPFILENOTIFY_ENDQUEUE Il commit della coda è terminato.
SPFILENOTIFY_ENDREGISTRATION La registrazione o l'annullamento della registrazione del file è stata completata.
SPFILENOTIFY_ENDRENAME Un'operazione di ridenominazione file è terminata.
SPFILENOTIFY_ENDSUBQUEUE Una coda secondaria (copia, ridenominazione o eliminazione) è terminata.
SPFILENOTIFY_FILEEXTRACTED Il file è stato estratto dal cabinet.
SPFILENOTIFY_FILEINCABINET Viene rilevato un file nell'archivio.
SPFILENOTIFY_FILEOPDELAYED Il file era 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 cabrio.
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 di file.
SPFILENOTIFY_STARTSUBQUEUE È stata avviata una coda secondaria (copia, ridenominazione o eliminazione).
SPFILENOTIFY_TARGETEXISTS Nella destinazione esiste già una copia del file specificato.
SPFILENOTIFY_TARGETNEWER Nella destinazione esiste una versione più recente del file specificato.