Compartir a través de


Acerca de la rutina de devolución de llamada de cola predeterminada

La rutina de devolución de llamada de cola predeterminada controla las notificaciones enviadas por SetupCommitFileQueue de forma genérica. Con la rutina predeterminada, se obtiene una interfaz de usuario lista para crear cuadros de diálogo de configuración comunes. Se recomienda usar la rutina de devolución de llamada de cola predeterminada, tanto para facilitar el uso como para garantizar una apariencia y un comportamiento coherentes de los cuadros de diálogo generados durante la instalación.

La rutina de devolución de llamada predeterminada requiere una estructura de contexto para el mantenimiento de registros internos. Además, la cola pasa información adicional relevante para la notificación actual en un conjunto de parámetros, Param1 y Param2.

Por ejemplo, si la cola envía una notificación SPFILENOTIFY_NEEDMEDIA a la rutina de devolución de llamada predeterminada, Param1 apunta a una estructura de SOURCE_MEDIA que contiene información sobre los medios necesarios y Param2 apunta a una matriz de caracteres que puede recibir nueva información de ruta de acceso del usuario.

La rutina de devolución de llamada predeterminada usa esta información para pedir al usuario que inserte los medios de origen necesarios, especifique una nueva ruta de acceso, omita copiar el archivo actual o cancelar la operación actual. La rutina de devolución de llamada de cola predeterminada devuelve FILEOP_NEWPATH, FILEOP_DOIT , FILEOP_SKIP o FILEOP_ABORT a la cola, en función de la acción que realizó el usuario.

Para obtener información sobre cómo la rutina de devolución de llamada de cola predeterminada controla cada notificación de cola, consulte Notificaciones de cola de archivos.

Para obtener información sobre las rutinas de devolución de llamada de cola personalizadas, consulte Creación de una rutina de devolución de llamada de cola personalizada.