Notificaciones (API de instalación)

Las notificaciones son valores que una función de configuración envía a una rutina de devolución de llamada para especificar un estado o evento. Dos parámetros, Param1 y Param2, se envían con la notificación y contienen información adicional relevante para la notificación.

La rutina de devolución de llamada procesa la notificación y devuelve un entero sin signo a la función de instalación. En función de la función de configuración, puede usar este valor para especificar una operación o selección de usuario, o puede omitirlo.

Las funciones de instalación envían notificaciones a rutinas de devolución de llamada mediante la sintaxis siguiente.

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

El parámetro Context es un puntero void a una variable o estructura de contexto que la rutina de devolución de llamada puede usar para almacenar información que debe conservarse entre las llamadas posteriores a la rutina de devolución de llamada.

Dado que la rutina de devolución de llamada especifica la implementación del contexto y nunca se hace referencia a ella ni se modifica mediante las funciones de configuración, el contexto no se documenta en el material de referencia para los mensajes de notificación siguientes.

El parámetro Notification especifica un valor entero sin signo para un evento o estado que hace que la función de instalación llame a la rutina de devolución de llamada.

Param1 y Param2 son parámetros opcionales que pueden contener información adicional relevante para la notificación. Estos parámetros son enteros sin signo. Si Param1 o Param2 devuelven información que no es un entero sin signo, se convierte en un entero sin signo y se debe redifusión a su tipo de datos original antes de que la rutina de devolución de llamada pueda usarla.

Nota

Las siguientes notificaciones representan todas las notificaciones usadas por las funciones de configuración. Las funciones individuales usan un subconjunto de estas notificaciones. En otras palabras, cada función usa no todas las notificaciones.

 

Las funciones de instalación usan las siguientes notificaciones.

Notification	Descripción
SPFILENOTIFY_COPYERROR	Error durante una operación de copia de archivos.
SPFILENOTIFY_DELETEERROR	Error durante una operación de eliminación de archivos.
SPFILENOTIFY_ENDCOPY	Ha finalizado una operación de copia de archivos.
SPFILENOTIFY_ENDDELETE	Ha finalizado una operación de eliminación de archivos.
SPFILENOTIFY_ENDQUEUE	La cola ha terminado de confirmarse.
SPFILENOTIFY_ENDREGISTRATION	El registro o anulación del registro del archivo ha finalizado.
SPFILENOTIFY_ENDRENAME	Finalizó una operación de cambio de nombre de archivo.
SPFILENOTIFY_ENDSUBQUEUE	Una subconsulta (copia, cambio de nombre o eliminación) ha finalizado.
SPFILENOTIFY_FILEEXTRACTED	El archivo se ha extraído del gabinete.
SPFILENOTIFY_FILEINCABINET	Se encuentra un archivo en el gabinete.
SPFILENOTIFY_FILEOPDELAYED	El archivo estaba en uso y la operación actual se ha retrasado hasta que se reinicie el sistema.
SPFILENOTIFY_LANGMISMATCH	El idioma de la operación actual no coincide con el idioma del sistema.
SPFILENOTIFY_NEEDMEDIA	Se requiere un nuevo medio de origen.
SPFILENOTIFY_NEEDNEWCABINET	El archivo actual continúa en el siguiente gabinete.
SPFILENOTIFY_QUEUESCAN	Se ha examinado un nodo de la cola de archivos.
SPFILENOTIFY_QUEUESCAN_EX	Se ha examinado un nodo de la cola de archivos.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO	Se ha examinado un nodo de la cola de archivos.
SPFILENOTIFY_RENAMEERROR	Error durante una operación de cambio de nombre de archivo.
SPFILENOTIFY_STARTCOPY	Se ha iniciado una operación de copia de archivos.
SPFILENOTIFY_STARTDELETE	Se ha iniciado una operación de eliminación de archivos.
SPFILENOTIFY_STARTQUEUE	La cola se ha iniciado para confirmar.
SPFILENOTIFY_STARTREGISTRATION	Se ha iniciado el registro o anulación del registro del archivo.
SPFILENOTIFY_STARTRENAME	Se ha iniciado una operación de cambio de nombre de archivo.
SPFILENOTIFY_STARTSUBQUEUE	Se ha iniciado una subconsulta (copia, cambio de nombre o eliminación).
SPFILENOTIFY_TARGETEXISTS	Ya existe una copia del archivo especificado en el destino.
SPFILENOTIFY_TARGETNEWER	Existe una versión más reciente del archivo especificado en el destino.