STD_ALERT Struktur (lmalert.h)

Artikel
08/24/2023

Die STD_ALERT-Struktur enthält die Uhrzeit und das Datum, an dem ein bedeutendes Ereignis aufgetreten ist. Die Struktur enthält auch eine Warnungsklasse und den Namen der Anwendung, die die Warnungsmeldung ausgibt. Sie müssen die STD_ALERT-Struktur angeben, wenn Sie eine Warnmeldung mit der NetAlertRaise-Funktion senden.

Syntax

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

Members

alrt_timestamp

Art: DWORD

Die Uhrzeit und das Datum des Ereignisses. Dieser Wert wird als die Anzahl von Sekunden gespeichert, die seit 00:00:00, 1. Januar 1970 GMT verstrichen sind.

alrt_eventname[EVLEN + 1]

Typ: WCHAR[EVLEN + 1]

Eine Unicode-Zeichenfolge, die die Warnungsklasse (Ereignistyp) angibt. Dieser Parameter kann einer der folgenden vordefinierten Werte oder eine andere Warnungsklasse sein, die Sie für Netzwerkanwendungen definiert haben. (Der Ereignisname für eine Warnung kann eine beliebige Textzeichenfolge sein.)

Name	Bedeutung
ALERT_ADMIN_EVENT	Ein Administratoreingriff ist erforderlich.
ALERT_ERRORLOG_EVENT	Dem Fehlerprotokoll wurde ein Eintrag hinzugefügt.
ALERT_MESSAGE_EVENT	Ein Benutzer oder eine Anwendung hat eine Broadcastnachricht empfangen.
ALERT_PRINT_EVENT	Ein Druckauftrag wurde abgeschlossen oder ein Druckfehler ist aufgetreten.
ALERT_USER_EVENT	Eine Anwendung oder Ressource wurde verwendet.

alrt_servicename[SNLEN + 1]

Typ: WCHAR[SNLEN + 1]

Eine Unicode-Zeichenfolge, die die Dienstanwendung angibt, die die Warnmeldung ausgibt.

Hinweise

Auf die STD_ALERT-Struktur muss eine ADMIN_OTHER_INFO-, ERRLOG_OTHER_INFO-, PRINT_OTHER_INFO- oder USER_OTHER_INFO-Struktur folgen. Auf diese Strukturen können optional Daten mit variabler Länge folgen. Die aufrufende Anwendung muss den Arbeitsspeicher für alle Strukturen und Daten mit variabler Länge in einem Warnungsmeldungspuffer zuordnen.

Unter NetAlertRaise finden Sie ein Codebeispiel, das mithilfe einer STD_ALERT-Struktur und einer ADMIN_OTHER_INFO-Struktur eine Administratorwarnung auslöst.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	lmalert.h (lm.h einschließen)