estrutura STD_ALERT (lmalert.h)

Artigo
03/14/2023

A estrutura STD_ALERT contém a hora e a data em que ocorreu um evento significativo. A estrutura também contém uma classe de alerta e o nome do aplicativo que está gerando a mensagem de alerta. Você deve especificar a estrutura STD_ALERT ao enviar uma mensagem de alerta usando a função NetAlertRaise .

Sintaxe

typedef struct _STD_ALERT {
  DWORD alrt_timestamp;
  WCHAR alrt_eventname[EVLEN + 1];
  WCHAR alrt_servicename[SNLEN + 1];
} STD_ALERT, *PSTD_ALERT, *LPSTD_ALERT;

Membros

alrt_timestamp

Tipo: DWORD

A hora e a data do evento. Esse valor é armazenado como o número de segundos decorridos desde 00:00:00, 1º de janeiro de 1970, GMT.

alrt_eventname[EVLEN + 1]

Tipo: WCHAR[EVLEN + 1]

Uma cadeia de caracteres Unicode que indica a classe de alerta (tipo de evento). Esse parâmetro pode ser um dos seguintes valores predefinidos ou outra classe de alerta que você definiu para aplicativos de rede. (O nome do evento para um alerta pode ser qualquer cadeia de texto.)

Nome	Significado
ALERT_ADMIN_EVENT	A intervenção de um administrador é necessária.
ALERT_ERRORLOG_EVENT	Uma entrada foi adicionada ao log de erros.
ALERT_MESSAGE_EVENT	Um usuário ou aplicativo recebeu uma mensagem de transmissão.
ALERT_PRINT_EVENT	Um trabalho de impressão foi concluído ou ocorreu um erro de impressão.
ALERT_USER_EVENT	Um aplicativo ou recurso foi usado.

alrt_servicename[SNLEN + 1]

Tipo: WCHAR[SNLEN + 1]

Uma cadeia de caracteres Unicode que indica o aplicativo de serviço que está gerando a mensagem de alerta.

Comentários

A estrutura STD_ALERT deve ser seguida por uma estrutura ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO ou USER_OTHER_INFO . Opcionalmente, essas estruturas podem ser seguidas por dados de comprimento variável. O aplicativo de chamada deve alocar a memória para todas as estruturas e dados de comprimento variável em um buffer de mensagem de alerta.

Consulte NetAlertRaise para obter um exemplo de código que gera um alerta administrativo usando uma estrutura STD_ALERT e uma estrutura ADMIN_OTHER_INFO .

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	lmalert.h (inclua Lm.h)