Notificações (API de Instalação)

As notificações são valores que uma função de instalação envia a uma rotina de retorno de chamada para especificar um estado ou evento. Dois parâmetros, Param1 e Param2, são enviados com a notificação e contêm informações adicionais relevantes para a notificação.

A rotina de retorno de chamada processa a notificação e retorna um inteiro sem sinal para a função de instalação. Dependendo da função de instalação, você pode usar esse valor para especificar uma operação ou seleção de usuário ou pode ignorá-la.

As funções de instalação enviam notificações para rotinas de retorno de chamada usando a sintaxe a seguir.

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //notification code
    Param1,          //additional notification information
    Param2           //additional notification information
);

O parâmetro Context é um ponteiro nulo para uma variável de contexto ou estrutura que a rotina de retorno de chamada pode usar para armazenar informações que devem persistir entre chamadas subsequentes à rotina de retorno de chamada.

Como a rotina de retorno de chamada especifica a implementação do contexto e nunca é referenciada ou alterada pelas funções de instalação, o contexto não está documentado no material de referência para as mensagens de notificação a seguir.

O parâmetro Notification especifica um valor inteiro sem sinal para um evento ou estado que faz com que a função de instalação chame a rotina de retorno de chamada.

param1 e param2 são parâmetros opcionais que podem conter informações adicionais relevantes para a notificação. Esses parâmetros são inteiros sem sinal. Se Param1 ou Param2 retornar informações que não são um inteiro sem sinal, ela será convertida em um inteiro sem sinal e deverá ser reformulada para seu tipo de dados original antes que possa ser usada pela rotina de retorno de chamada.

As notificações a seguir são usadas pelas funções de instalação.