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

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

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

Por exemplo, se a fila envia uma notificação de SPFILENOTIFY_NEEDMEDIA para a rotina de retorno de chamada padrão, Param1 aponta para uma estrutura de SOURCE_MEDIA que contém informações sobre a mídia necessária e Param2 aponta 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 da ação que 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 File Queue Notifications.

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