Criando uma rotina de retorno de chamada de gabinete
Como a API de Instalação não fornece uma rotina de retorno de chamada de gabinete padrão, você precisa fornecer uma rotina. A rotina de retorno de chamada que a função SetupIterateCabinet requer deve ter o mesmo formato que aqueles apontados por FileCallback.
A seguir está a sintaxe que SetupIterateCabinet usa para enviar uma notificação para a rotina de retorno de chamada.
MsgHandler( //the specified callback routine
Context, //context used by the callback routine
Notification, //cabinet notification
Param1, //additional notification information
Param2 //additional notification information
);
O parâmetro Context é um ponteiro nulo para uma variável de contexto ou estrutura que pode ser usada pela rotina de retorno de chamada para armazenar informações que precisam persistir entre chamadas subsequentes para a rotina de retorno de chamada.
A implementação desse contexto é especificada pela rotina de retorno de chamada e nunca é referenciada ou alterada por SetupIterateCabinet.
O parâmetro Notification é um inteiro sem sinal e será um dos valores a seguir.
| Notificação | Descrição |
|---|---|
| SPFILENOTIFY_FILEEXTRACTED | O arquivo foi extraído do gabinete. |
| SPFILENOTIFY_FILEINCABINET | Um arquivo é encontrado no gabinete. |
| SPFILENOTIFY_NEEDNEWCABINET | O arquivo atual continua no próximo gabinete. |
Os dois parâmetros finais, Param1 e Param2, também são inteiros sem sinal e contêm informações adicionais relevantes para a notificação. Para obter mais informações sobre as notificações enviadas por SetupIterateCabinet, consulte Notificações de arquivo de gabinete.
Uma rotina SP_FILE_NOTIFY_CALLBACK retorna um inteiro sem sinal. A rotina de retorno de chamada do gabinete deve retornar um dos valores a seguir, dependendo da notificação.
Para a notificação de SPFILENOTIFY_FILEINCABINET, SetupIterateCabinet espera que um dos valores a seguir seja retornado pela rotina de retorno de chamada.
| Valor | Significado |
|---|---|
| FILEOP_ABORT | Anular o processamento do gabinete. |
| FILEOP_DOIT | Extraia o arquivo atual. |
| FILEOP_SKIP | Ignore o arquivo atual. |
Para SPFILENOTIFY_NEEDNEWCABINET e SPFILENOTIFY_FILEEXTRACTED notificações, SetupIterateCabinet espera que um dos valores a seguir seja retornado pela rotina de retorno de chamada.
| Valor | Significado |
|---|---|
| NO_ERROR | Nenhum erro foi encontrado, continue processando o gabinete. |
| ERROR_XXX | Ocorreu um erro do tipo especificado. A função SetupIterateCabinet retornará FALSE e o código de erro especificado será retornado por uma chamada para GetLastError. |
Se a rotina de retorno de chamada retornar FILEOP_DOIT, a rotina também deverá fornecer um caminho de destino completo. Para obter mais informações , consulte SPFILENOTIFY_FILEINCABINET.