Funções de alerta

[As funções de alerta não são suportadas a partir do Windows Vista porque os serviços de alerta e mensageiro não são suportados.]

As funções de alerta de gerenciamento de rede notificam programas e aplicativos de serviço de rede sobre eventos de rede. Um de eventos é uma instância específica de um processo, ocorrência ou estado de hardware, conforme definido por um aplicativo. As funções de alerta permitem que os aplicativos indiquem quando eventos predefinidos ocorrem.

Windows Server 2003: Os serviços de alerta e mensageiro são desabilitados por padrão no Windows Server 2003. Você deve reativar os serviços antes de chamar as funções de alerta de gerenciamento de rede ou as funções de gerenciamento de rede mensagem.

As funções de alerta estão listadas a seguir.

Função	Descrição
NetAlertRaise	Notifica todos os clientes registrados de que um evento específico ocorreu.
NetAlertRaiseEx	Simplifica a notificação de clientes registrados de que um evento específico ocorreu, porque, ao contrário NetAlertRaise , NetAlertRaiseEx não requer uma estrutura STD_ALERT.

 

O serviço de alerta deve estar em execução no computador cliente quando você chama a função NetAlertRaise ou a função NetAlertRaiseEx. Se o serviço não estiver em execução, as funções falharão com ERROR_FILE_NOT_FOUND. O serviço de alerta no cliente chama a função NetMessageBufferSend para enviar informações aos destinatários.

Aplicativos, serviços de rede e componentes de rede interna usam as funções de alerta de gerenciamento de rede para gerar um alerta, notificando vários aplicativos ou usuários quando ocorre um determinado tipo de evento. As funções de categoria de alerta, tipos de dados, estruturas e constantes são definidas no LMCONS. H, LMERR. H, e LMALERT. Arquivos de cabeçalho H. Para acessar essas definições, defina as constantes INCL_NETERRORS e INCL_NETALERT e inclua o arquivo de cabeçalho LM.H.

O LMALERT. O arquivo H predefine as seguintes classes de alerta (tipos de eventos de rede) para o envio de alertas:

• Eventos de rede que requerem assistência administrativa
• Adição de uma entrada a um arquivo de log de erros
• Receção de uma mensagem difundida por um utilizador ou uma aplicação
• Conclusão de um trabalho de impressão
• Utilização de determinadas aplicações ou recursos pelos utilizadores

Você pode definir outras classes de alertas para aplicativos de rede conforme necessário. Por exemplo, se um aplicativo em um servidor grava rotineiramente grandes quantidades de dados em uma unidade de disco, o aplicativo corre o risco de encher o disco. Nesse caso, convém adicionar o evento "sem espaço livre em disco" para disparar um alerta que notifica o aplicativo para pausar ou encerrar o processo que está preenchendo o disco. O nome do evento para um alerta pode ser qualquer cadeia de texto.

Quando você gera um alerta com uma chamada para a funçãoNetAlertRaise, os dados da mensagem devem consistir em uma estrutura de cabeçalho STD_ALERT, seguida por dados adicionais de comprimento fixo específicos do alerta em um ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO, ou USER_OTHER_INFO estrutura. Dados adicionais de comprimento variável podem seguir a estrutura específica do alerta. (As chamadas para a funçãoNetAlertRaiseEx donão requerem uma estrutura STD_ALERT.) O aplicativo de chamada deve alocar a memória para todas as estruturas e dados de comprimento variável e liberar a memória após o retorno da chamada.

As macros a seguir estão disponíveis para uso com buffers de dados de alerta.

Macro	Descrição
ALERT_OTHER_INFO	Retorna um ponteiro para os dados de comprimento fixo que seguem a estrutura STD_ALERT em uma mensagem de alerta.
ALERT_VAR_DATA	Retorna um ponteiro para os dados de comprimento variável que seguem os dados específicos do alerta em uma mensagem de alerta.

 

Em vez de usar as funções de alerta de gerenciamento de rede, você poderá usar o SDK do WMI (Instrumentação de Gerenciamento do Windows) para notificação de eventos. Para obter mais informações sobre as plataformas que suportam o modelo de evento WMI, consulte de infraestrutura WMI e de eventos de monitoramento na documentação do WMI.