Freigeben über


Warnungsfunktionen

[Die Warnungsfunktionen werden ab Windows Vista nicht unterstützt, da die Warnungs- und Messengerdienste nicht unterstützt werden.]

Die Netzwerkverwaltungswarnungsfunktionen benachrichtigen Netzwerkdienstprogramme und -anwendungen über Netzwerkereignisse. Ein Ereignis ist ein bestimmter instance eines Prozesses, vorkommens oder Zustands von Hardware, wie von einer Anwendung definiert. Mit den Warnungsfunktionen können Anwendungen angeben, wann vordefinierte Ereignisse auftreten.

Windows Server 2003: Die Warnungs- und Messengerdienste sind unter Windows Server 2003 standardmäßig deaktiviert. Sie müssen die Dienste erneut aktivieren, bevor Sie die Warnungsfunktionen der Netzwerkverwaltung oder die Nachrichtenfunktionen der Netzwerkverwaltung aufrufen.

Die Warnungsfunktionen sind im Folgenden aufgeführt.

Funktion BESCHREIBUNG
NetAlertRaise Benachrichtigt alle registrierten Clients, dass ein bestimmtes Ereignis aufgetreten ist.
NetAlertRaiseEx Vereinfacht die Benachrichtigung registrierter Clients über ein bestimmtes Ereignis, da NetAlertRaise im Gegensatz zu NetAlertRaise keine STD_ALERT-Struktur erfordert.

 

Der Warnungsdienst muss auf dem Clientcomputer ausgeführt werden, wenn Sie die NetAlertRaise-Funktion oder die NetAlertRaiseEx-Funktion aufrufen. Wenn der Dienst nicht ausgeführt wird, schlagen die Funktionen mit ERROR_FILE_NOT_FOUND fehl. Der Warnungsdienst auf dem Client ruft die NetMessageBufferSend-Funktion auf, um Informationen an Empfänger zu senden.

Anwendungen, Netzwerkdienste und interne Netzwerkkomponenten verwenden die Netzwerkverwaltungswarnungsfunktionen, um eine Warnung auszulösen und verschiedene Anwendungen oder Benutzer zu benachrichtigen, wenn ein bestimmter Typ von Ereignis auftritt. Die Warnungskategoriefunktionen, Datentypen, Strukturen und Konstanten werden im LMCONS definiert. H, LMERR. H und LMALERT. H-Headerdateien. Um auf diese Definitionen zuzugreifen, definieren Sie die Konstanten INCL_NETERRORS und INCL_NETALERT, und schließen Sie die Headerdatei LM.H ein.

Die LMALERT. H-Datei definiert die folgenden Warnungsklassen (Arten von Netzwerkereignissen) für das Senden von Warnungen:

  • Netzwerkereignisse, die administrative Unterstützung erfordern
  • Hinzufügen eines Eintrags zu einer Fehlerprotokolldatei
  • Empfang einer Gesendeten Nachricht durch einen Benutzer oder eine Anwendung
  • Abschluss eines Druckauftrags
  • Nutzung bestimmter Anwendungen oder Ressourcen durch Benutzer

Sie können bei Bedarf andere Warnungsklassen für Netzwerkanwendungen definieren. Wenn beispielsweise eine Anwendung auf einem Server routinemäßig große Datenmengen auf ein Datenträgerlaufwerk schreibt, läuft die Anwendung Gefahr, den Datenträger zu füllen. In diesem Fall können Sie das Ereignis "Kein freier Speicherplatz" hinzufügen, um eine Warnung auszulösen, die die Anwendung benachrichtigt, den Prozess anzuhalten oder zu beenden, der den Datenträger füllt. Der Ereignisname für eine Warnung kann eine beliebige Textzeichenfolge sein.

Wenn Sie eine Warnung mit einem Aufruf der NetAlertRaise-Funktion auslösen, sollten die Nachrichtendaten aus einer STD_ALERT Headerstruktur bestehen, gefolgt von zusätzlichen Daten mit fester Länge, die warnungsspezifisch in einer ADMIN_OTHER_INFO-, ERRLOG_OTHER_INFO-, PRINT_OTHER_INFO- oder USER_OTHER_INFO-Struktur sind. Zusätzliche Daten mit variabler Länge können der warnungsspezifischen Struktur folgen. (Aufrufe der NetAlertRaiseEx-Funktion erfordern keine STD_ALERT Struktur.) Die aufrufende Anwendung muss den Arbeitsspeicher für alle Strukturen und Daten mit variabler Länge zuordnen und den Arbeitsspeicher freigeben, nachdem der Aufruf zurückgegeben wurde.

Die folgenden Makros stehen für die Verwendung mit Warnungsdatenpuffern zur Verfügung.

Makro Beschreibung
ALERT_OTHER_INFO Gibt einen Zeiger auf die Daten fester Länge zurück, die der STD_ALERT-Struktur in einer Warnmeldung folgen.
ALERT_VAR_DATA Gibt einen Zeiger auf die Daten variabler Länge zurück, die den warnungsspezifischen Daten in einer Warnmeldung folgen.

 

Anstelle der Netzwerkverwaltungswarnungsfunktionen können Sie möglicherweise das WMI-SDK (Windows Management Instrumentation) für Ereignisbenachrichtigungen verwenden. Weitere Informationen zu den Plattformen, die das WMI-Ereignismodell unterstützen, finden Sie unter WMI-Infrastruktur- und Überwachungsereignisse in der WMI-Dokumentation.