Warnungsfunktionen

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

Die Warnungsfunktionen der Netzwerkverwaltung benachrichtigen Netzwerkdienstprogramme und Anwendungen über Netzwerkereignisse. Ein Ereignis ist eine bestimmte Instanz eines Prozesses, eines Vorkommens oder eines Hardwarezustands, wie von einer Anwendung definiert. Mit den Warnungsfunktionen können Anwendungen angeben, wann vordefinierte Ereignisse auftreten.

Windows Server 2003: Die Warnungs- und Messenger-Dienste sind standardmäßig auf Windows Server 2003 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
NetAlertR period Benachrichtigt alle registrierten Clients, dass ein bestimmtes Ereignis aufgetreten ist.
NetAlertRerklärex Vereinfacht die Benachrichtigung registrierter Clients, dass ein bestimmtes Ereignis aufgetreten ist, da NetAlertRerklär im Gegensatz zu NetAlertRandroEx keine STD _ ALERT-Struktur erfordert.

Der Warnungsdienst muss auf dem Clientcomputer ausgeführt werden, wenn Sie die NetAlertR function oder die NetAlertRandroEx-Funktion aufrufen. Wenn der Dienst nicht ausgeführt wird, tritt bei den Funktionen ein Fehler mit _ FEHLERDATEI _ NICHT GEFUNDEN _ auf. Der Warnungsdienst auf dem Client ruft die NetMessageBufferSend-Funktion auf, um Informationen an Empfänger zu senden.

Anwendungen, Netzwerkdienste und interne Netzwerkkomponenten verwenden die Warnungsfunktionen der Netzwerkverwaltung, um eine Warnung zu erstellen und verschiedene Anwendungen oder Benutzer zu benachrichtigen, wenn eine bestimmte Art von Ereignis auftritt. Die Warnungskategoriefunktionen, Datentypen, Strukturen und Konstanten werden in LMCONS definiert. H, LMERR. H und LMALERT. H-Headerdateien. Um auf diese Definitionen zu zugreifen, definieren Sie die Konstanten INCL _ NETERRORS und INCL NETALERT, und schließen _ Sie die Headerdatei LM.H ein.

The LMALERT. Die H-Datei definiert die folgenden Warnungsklassen (Arten von Netzwerkereignissen) zum Senden von Warnungen:

  • Netzwerkereignisse, die Administrative Unterstützung erfordern
  • Addition eines Eintrags zu einer Fehlerprotokolldatei
  • Empfang einer Broadcastnachricht durch einen Benutzer oder eine Anwendung
  • Abschluss eines Druckauftrags
  • Verwendung 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 Laufwerk schreibt, besteht das Risiko, dass die Anwendung den Datenträger füllt. In diesem Fall können Sie das Ereignis "Kein freier Speicherplatz" hinzufügen, um eine Warnung auszulösen, die die Anwendung darüber informiert, dass sie angehalten oder den Prozess beendet, 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 NetAlertRadmin-Funktion ausgelöst haben, sollten die Nachrichtendaten aus einer STD _ ALERT-Headerstruktur gefolgt von zusätzlichen Daten fester Länge bestehen, die warnungsspezifisch in einer ADMIN OTHER _ _ INFO-, ERRLOG _ OTHER _ INFO-, PRINT OTHER _ _ INFO-oder USER OTHER _ _ INFO-Struktur sind. Zusätzliche Daten variabler Länge können der warnungsspezifischen Struktur folgen. (Aufrufe der NetAlertRerklärEx-Funktion erfordern keine STD _ ALERT-Struktur.) Die aufrufende Anwendung muss den Arbeitsspeicher für alle Strukturen und Daten variabler Länge zuordnen und den Arbeitsspeicher nach der Rückgabe des Aufrufs frei geben.

Die folgenden Makros sind für die Verwendung mit Warnungsdatenpuffern verfügbar.

Makro Beschreibung
WARNUNG _ ANDERE _ INFORMATIONEN Gibt einen Zeiger auf die Daten fester Länge zurück, die der STD _ ALERT-Struktur in einer Warnmeldung folgen.
_ _ WARNUNGS-VAR-DATEN Gibt einen Zeiger auf die Daten variabler Länge zurück, die auf die warnungsspezifischen Daten in einer Warnmeldung folgen.

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