STD_ALERT Struktur (lmalert.h)

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)

Weitere Informationen

ADMIN_OTHER_INFO

Warnungsfunktionen

ERRLOG_OTHER_INFO

NetAlertRaise

Übersicht über die Netzwerkverwaltung

Netzwerkverwaltungsstrukturen

PRINT_OTHER_INFO

USER_OTHER_INFO