структура STD_ALERT (lmalert.h)

Статья
03/14/2023

Структура STD_ALERT содержит время и дату возникновения значимого события. Структура также содержит класс оповещения и имя приложения, которое вызывает оповещение. При отправке оповещения с помощью функции NetAlertRaise необходимо указать структуру STD_ALERT.

Синтаксис

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

Члены

alrt_timestamp

Тип: DWORD

Время и дата события. Это значение хранится в виде количества секунд, прошедших с 00:00:00 1 января 1970 года по Гринвичу.

alrt_eventname[EVLEN + 1]

Тип: WCHAR[EVLEN + 1]

Строка Юникода, указывающая класс оповещения (тип события). Этот параметр может быть одним из следующих предопределенных значений или другим классом оповещений, определенным для сетевых приложений. (Имя события для оповещения может быть любой текстовой строкой.)

Имя	Значение
ALERT_ADMIN_EVENT	Требуется вмешательство администратора.
ALERT_ERRORLOG_EVENT	В журнал ошибок добавлена запись.
ALERT_MESSAGE_EVENT	Пользователь или приложение получили широковещательное сообщение.
ALERT_PRINT_EVENT	Задание печати завершено или произошла ошибка печати.
ALERT_USER_EVENT	Использовалось приложение или ресурс.

alrt_servicename[SNLEN + 1]

Тип: WCHAR[SNLEN + 1]

Строка Юникода, указывающая приложение-службу, которое вызывает оповещение.

За структурой STD_ALERT должна следовать одна структура ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO или USER_OTHER_INFO . За этими структурами при необходимости могут следовать данные переменной длины. Вызывающее приложение должно выделить память для всех структур и данных переменной длины в буфере сообщений оповещений.

Пример кода, который создает административное оповещение с помощью структуры STD_ALERT и структуры ADMIN_OTHER_INFO, см. в статье NetAlertRaise.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	lmalert.h (включая Lm.h)