Warnungsfunktionen

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

Die Netzwerkverwaltungsbenachrichtigungsfunktionen 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 Messengerdienste sind unter Windows Server 2003 standardmäßig deaktiviert. Sie müssen die Dienste erneut aktivieren, bevor Sie die Netzwerkverwaltungsbenachrichtigungsfunktionen oder die Netzwerkverwaltung Nachrichtenfunktionenaufrufen.

Die Warnungsfunktionen sind im Folgenden aufgeführt.

Der Warndienst 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_FOUNDfehl. Der Warnungsdienst auf dem Client ruft die NetMessageBufferSend-Funktion auf, um Informationen an Empfänger zu senden.

Anwendungen, Netzwerkdienste und interne Netzwerkkomponenten verwenden die Benachrichtigungsfunktionen für die Netzwerkverwaltung, um eine Warnung auszuheben und verschiedene Anwendungen oder Benutzer zu benachrichtigen, wenn ein bestimmter Ereignistyp 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.

Das LMALERT. H-Datei vordefinierte die folgenden Warnungsklassen (Arten von Netzwerkereignissen) zum Senden von Warnungen:

• Netzwerkereignisse, die Administrative Unterstützung erfordern
• Hinzufügen eines Eintrags zu einer Fehlerprotokolldatei
• Empfang einer Übertragungsnachricht 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 regelmäßig große Datenmengen auf ein Laufwerk schreibt, besteht das Risiko, dass der Datenträger gefüllt wird. In diesem Fall möchten Sie möglicherweise das Ereignis "kein freier Speicherplatz" hinzufügen, um eine Warnung auszulösen, die die Anwendung benachrichtigt, anzuhalten oder den Prozess zu beenden, der den Datenträger ausfü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 Kopfzeilenstruktur bestehen, gefolgt von zusätzlichen Daten mit fester Länge, die warnungsspezifisch in einem ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO, oder USER_OTHER_INFO Struktur. 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 Speicher für alle Strukturen und Daten mit variabler Länge zuweisen und den Speicher freigeben, nachdem der Aufruf zurückgegeben wurde.

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

Anstatt die Netzwerkverwaltungsbenachrichtigungsfunktionen zu verwenden, 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 in der WMI-Dokumentation WMI Infrastructure und Monitoring Events.