Compartir a través de


Notificaciones (API de configuració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 configuració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 bien 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 de contexto o estructura 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 la modifican 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 configuració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 devolver información que no es un entero sin signo, se convierte en un entero sin signo y se debe volver a transmitir 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 instalación. Las funciones individuales usan un subconjunto de estas notificaciones. En otras palabras, no todas las notificaciones las usa cada función.

 

Las funciones de configuración usan las siguientes notificaciones.

Notificación 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 Ha finalizado una operación de cambio de nombre de archivo.
SPFILENOTIFY_ENDSUBQUEUE Ha finalizado una subconsulta (copia, cambio de nombre o eliminación).
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 la 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.