Desenvolvendo uma função de retorno de chamada de fila personalizada

Além de usar o retorno de chamada de fila padrão, você pode escrever uma rotina de retorno de chamada personalizada. Esta função deve ter o mesmo formato que FileCallback. Isso é útil se precisar de uma rotina de callback para lidar com uma notificação de uma maneira diferente da fornecida pela rotina de callback de fila padrão.

Se apenas uma pequena parte do comportamento da rotina de retorno de chamada da fila padrão precisar ser alterada, poderá criar uma rotina de retorno de chamada personalizada para filtrar as notificações, gerindo apenas aquelas que exigem comportamento especial e chamando SetupDefaultQueueCallback para os restantes.

Por exemplo, se desejasse manipular erros de eliminação de ficheiro personalizados, poderia criar uma função callback personalizada, MyCallback. Essa função intercetaria e processaria notificações SPFILENOTIFY_DELETEERROR e chamaria a função de retorno de chamada de fila padrão para todas as outras notificações. MyCallback retorna um valor para as notificações de erro de exclusão. Para todas as outras notificações, MyCallback passa qualquer valor que a rotina de retorno de chamada da fila padrão tenha retornado à fila.

Este fluxo de controlo é ilustrado no diagrama seguinte.

Importante

Se a função de callback personalizada chamar a rotina de callback da fila padrão, deverá passar o ponteiro de tipo void retornado por SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx para a rotina de callback padrão.