Crear una rutina de devolución de llamada de cola personalizada

Además de usar la devolución de llamada de cola predeterminada, puede escribir una rutina de devolución de llamada personalizada. Esta función debe tener el mismo formato que FileCallback. Esto es útil si necesita una rutina de devolución de llamada para controlar una notificación de una manera distinta de la proporcionada por la rutina de devolución de llamada de cola predeterminada.

Si solo es necesario cambiar una pequeña parte del comportamiento de la rutina de devolución de llamada de cola predeterminada, puede crear una rutina de devolución de llamada personalizada para filtrar las notificaciones, controlando solo las que requieren un comportamiento especial y llamando a SetupDefaultQueueCallback para los demás.

Por ejemplo, si desea controlar los errores de eliminación de archivos personalizados, podría crear una función de devolución de llamada personalizada, MyCallback. Esta función interceptaría y procesaría SPFILENOTIFY_DELETEERROR notificaciones y llamaría a la función de devolución de llamada de cola predeterminada para todas las demás notificaciones. MyCallback devuelve un valor para las notificaciones de error de eliminación. Para todas las demás notificaciones, MyCallback pasa cualquier valor que la rutina de devolución de llamada de cola predeterminada devuelta a la cola.

Este flujo de control se muestra en el diagrama siguiente.

Importante

Si la función de devolución de llamada personalizada llama a la rutina de devolución de llamada de cola predeterminada, debe pasar el puntero void devuelto por SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx a la rutina de devolución de llamada predeterminada.