Sobre a rotina de retorno de chamada de fila padrão

A rotina de retorno de chamada de fila padrão manipula as notificações enviadas por SetupCommitFileQueue de maneira genérica. Usando a rotina padrão, você obtém uma interface do usuário pronta para criar caixas de diálogo de configuração comuns. É recomendável que você use a rotina de retorno de chamada de fila padrão, tanto para facilitar o uso quanto para garantir uma aparência consistente e um comportamento das caixas de diálogo geradas durante a instalação.

A rotina de retorno de chamada padrão requer uma estrutura de contexto para manutenção de registros internos. Além disso, a fila passa informações adicionais relevantes para a notificação atual em um conjunto de parâmetros, Param1 e Param2.

Por exemplo, se a fila enviar uma notificação de SPFILENOTIFY_NEEDMEDIA para a rotina de retorno de chamada padrão, Param1 apontará para uma estrutura SOURCE_MEDIA que contém informações sobre a mídia necessária e Param2 apontará para uma matriz de caracteres que pode receber novas informações de caminho do usuário.

A rotina de retorno de chamada padrão usa essas informações para solicitar que o usuário insira a mídia de origem necessária, especifique um novo caminho, ignore a cópia do arquivo atual ou cancele a operação atual. A rotina de retorno de chamada de fila padrão retorna FILEOP_NEWPATH, FILEOP_DOIT , FILEOP_SKIP ou FILEOP_ABORT para a fila, dependendo de qual ação o usuário tomou.

Para obter informações sobre como a rotina de retorno de chamada de fila padrão lida com cada notificação de fila, consulte Notificações da Fila de Arquivos.

Para obter informações sobre rotinas personalizadas de retorno de chamada de fila, consulte Criando uma rotina de retorno de chamada de fila personalizada.