SMTPEventConsumer-Klasse
Die SMTPEventConsumer-Klasse sendet bei jeder Übermittlung eines Ereignisses eine E-Mail-Nachricht über das Simple Mail Transfer Protocol (SMTP). Im Netzwerk muss ein SMTP-Server vorhanden sein. Die SMTPEventConsumer-Klasse unterstützt keine Anhänge. Die Codierung der E-Mail-Nachricht muss US-ASCII sein.
Diese Klasse ist einer der Standardereignisconsumer, die WMI bereitstellt. Ein Beispiel für die Verwendung von SMTPEventConsumer zum Erstellen eines Consumers finden Sie unter Senden von E-Mails basierend auf einem Ereignis. Weitere Informationen finden Sie unter Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern.
Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden werden in alphabetischer Reihenfolge aufgeführt, nicht in MOF-Reihenfolge.
Syntax
[AMENDMENT]
class SMTPEventConsumer : __EventConsumer
{
uint8 CreatorSID[];
string MachineName;
uint32 MaximumQueueSize;
string BccLine;
string CcLine;
string FromLine;
string HeaderFields[];
string Message;
string Name;
string ReplyToLine;
string SMTPServer;
string Subject;
string ToLine;
};
Member
Die SMTPEventConsumer-Klasse verfügt über diese Membertypen:
Eigenschaften
Die SMTPEventConsumer-Klasse verfügt über diese Eigenschaften.
-
BccLine
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine durch Komma oder Semikolon getrennte Liste mit Adressen – im Format einer Standard-Zeichenfolgenvorlage –, die die nicht sichtbaren Empfänger enthält, an die die Nachricht gesendet wird. Weitere Informationen finden Sie in diesem Thema im Abschnitt „Hinweise“.
-
-
CcLine
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine durch Komma oder Semikolon getrennte Liste mit Adressen – im Format einer Standard-Zeichenfolgenvorlage –, die die sichtbaren Empfänger enthält, an die die Nachricht gesendet wird. Weitere Informationen finden Sie in diesem Thema im Abschnitt „Hinweise“.
-
-
CreatorSID
-
-
Datentyp: uint8-Array
-
Zugriffstyp: Schreibgeschützt
Die Sicherheits-ID (SID), die den Benutzer oder die Benutzerin, der/die einen Filter erstellt, eindeutig identifiziert. Je nach Betriebssystem speichert WMI die SID des Benutzers bzw. der Benutzerin, der/die eine Instanz von __EventConsumer erstellt, oder die Administrator-SID. Weitere Informationen finden Sie unter Binden eines Ereignisfilters an einen logischen Consumer und Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern.
Diese Eigenschaft wird von __EventConsumer geerbt.
-
-
FromLine
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Die Zeile „Von“ einer E-Mail-Nachricht im Format einer Standard-Zeichenfolgenvorlage. Wenn der Wert NULL ist, wird eine Von-Zeile im Format „WinMgmt@MachineName“ erstellt.
-
-
HeaderFields
-
-
Datentyp: string-Array
-
Zugriffstyp: Schreibgeschützt
Ein Array aus Headerfeldern, die ohne Interpretation in eine E-Mail-Nachricht eingefügt werden.
-
-
MachineName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name des Computers, an den die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) Ereignisse sendet.
Diese Eigenschaft wird von __EventConsumer geerbt.
-
-
MaximumQueueSize
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Die maximale Warteschlange für einen bestimmten Consumer in Byte.
Diese Eigenschaft wird von __EventConsumer geerbt.
-
-
Meldung
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Die Standard-Zeichenfolgenvorlage, die den Text einer E-Mail-Nachricht enthält.
-
-
Name
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: key
Der eindeutige Bezeichner für den Ereignisconsumer.
-
-
ReplyToLine
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Die Zeile „Antwort an“ einer E-Mail-Nachricht im Format einer Standard-Zeichenfolgenvorlage. Wenn der Wert NULL ist, wird keine Antwort an-Zeile verwendet.
-
-
SMTPServer
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name des SMTP-Servers, über den eine E-Mail gesendet wird. Zulässige Namen sind eine IP-Adresse oder ein DNS- oder NetBIOS-Name. Diese Eigenschaft darf nicht NULL sein.
-
-
Subject
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Die Standard-Zeichenfolgenvorlage, die den Betreff einer E-Mail-Nachricht enthält.
-
-
ToLine
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine durch Komma oder Semikolon getrennte Liste mit Adressen – im Format einer Standard-Zeichenfolgenvorlage –, die angibt, wohin die Nachricht gesendet werden soll. Weitere Informationen finden Sie in diesem Thema im Abschnitt „Hinweise“.
-
Bemerkungen
Die SMTPEventConsumer-Klasse wird aus der abstrakten Klasse __EventConsumer abgeleitet.
Einige der Eigenschaften ToLine, CcLine oder BccLine dürfen NULL sein, es dürfen aber nicht alle NULL sein.
Der Empfang eines Fehlerrückgabecodes vom SMTP-Dienst wird als Fehler betrachtet.
Beispiele
Ein Beispiel für die Verwendung von SMTPEventConsumer zum Erstellen eines Consumers finden Sie unter Senden von E-Mails basierend auf einem Ereignis. Weitere Informationen finden Sie unter Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Root\subscription |
| MOF |
|
| DLL |
|