Classe SMTPEventConsumer

Article
06/29/2023

La classe SMTPEventConsumer envoie un e-mail à l’aide du protocole SMTP (Simple Mail Transfer Protocol) chaque fois qu’un événement lui est remis. Un serveur SMTP doit exister sur le réseau. La classe SMTPEventConsumer ne prend pas en charge les pièces jointes. L’encodage du message électronique doit être US-ASCII.

Cette classe est l’un des consommateurs d’événements standards fournis par WMI. Pour obtenir un exemple d’utilisation de SMTPEventConsumer pour créer un consommateur, consultez Envoi d’un e-mail en fonction d’un événement. Pour plus d’informations, consultez Suivi et réponse aux événements avec des consommateurs standards.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont classées dans l’ordre alphabétique, pas dans l’ordre MOF.

Syntaxe

[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;
};

Membres

La classe SMTPEventConsumer possède les types de membres suivants :

Propriétés

Propriétés

La classe SMTPEventConsumer possède les propriétés suivantes.

BccLine

Type de données : chaîne
Type d'accès : Lecture seule

Liste d’adresses, séparées par une virgule ou un point-virgule, au format d’un modèle de chaîne standard à laquelle le message est envoyé en tant que copie carbone aveugle. Pour plus de détails, consultez la section Remarques.

CcLine

Type de données : chaîne
Type d'accès : Lecture seule

Liste d’adresses, séparées par une virgule ou un point-virgule, au format d’un modèle de chaîne standard à laquelle le message est envoyé en tant que copie carbone. Pour plus de détails, consultez la section Remarques.

CreatorSID

Type de données : tableau uint8
Type d'accès : Lecture seule

Identificateur de sécurité (SID) qui identifie de manière unique l’utilisateur qui crée un filtre. WMI stocke le SID de l’utilisateur qui crée une instance de __EventConsumer ou le SID de l’administrateur, en fonction du système d’exploitation. Pour plus d’informations, consultez Liaison d’un filtre d’événement à un consommateur logique et Monitoring des événements et réponse à ces derniers avec des consommateurs standard.

Cette propriété provient de __EventConsumer.

FromLine

Type de données : chaîne
Type d'accès : Lecture seule

Ligne d’un message électronique au format d’un modèle de chaîne standard. Si la valeur est NULL, une ligne From est construite sous la forme « WinMgmt@NomDeMachine ».

HeaderFields

Type de données : tableau de chaînes
Type d'accès : Lecture seule

Tableau de champs d’en-tête insérés dans un e-mail sans interprétation.

MachineName

Type de données : chaîne
Type d'accès : Lecture seule

Nom de l’ordinateur auquel WMI (Windows Management Instrumentation) envoie les événements.

Cette propriété est héritée de __EventConsumer.

MaximumQueueSize

Type de données : uint32
Type d'accès : Lecture seule

File d’attente maximale pour un consommateur spécifique, en octets.

Cette propriété provient de __EventConsumer.

Message

Type de données : chaîne
Type d'accès : Lecture seule

Modèle de chaîne standard qui contient le corps d’un e-mail.

Nom

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Clé

Identificateur unique du consommateur d’événements.

ReplyToLine

Type de données : chaîne
Type d'accès : Lecture seule

Ligne de réponse d’un e-mail au format d’un modèle de chaîne standard. Si la valeur est NULL, aucune ligne Reply-to n’est utilisée.

SMTPServer

Type de données : chaîne
Type d'accès : Lecture seule

Nom du serveur SMTP par l’intermédiaire duquel un e-mail est envoyé. Les noms autorisés sont une adresse IP, ou un nom DNS ou NetBIOS. Cette propriété ne peut pas avoir la valeur NULL.

Subject

Type de données : chaîne
Type d'accès : Lecture seule

Modèle de chaîne standard qui contient l’objet d’un e-mail.

ToLine

Type de données : chaîne
Type d'accès : Lecture seule

Liste d’adresses, séparées par une virgule ou un point-virgule, au format d’un modèle de chaîne standard qui identifie l’emplacement d’envoi du message. Pour plus de détails, consultez la section Remarques.

Notes

La classe SMTPEventConsumer est dérivée de la classe abstraite __EventConsumer.

Certaines des propriétés ToLine, CcLine ou BccLine peuvent contenir la valeur NULL, mais elles ne peuvent pas toutes être NULL.

La réception d’un code de retour d’erreur venant du service SMTP est considérée comme un échec.

Exemples

Pour obtenir un exemple d’utilisation de SMTPEventConsumer pour créer un consommateur, consultez Envoi d’un e-mail en fonction d’un événement. Pour plus d’informations, consultez Suivi et réponse aux événements avec des consommateurs standards.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Root\subscription
MOF	Smtpcons.mof
DLL	Smtpcons.dll

Voir aussi

__EventConsumer
Classes de consommateurs standards
Envoi d’un e-mail en fonction d’un événement
Création d’un consommateur logique
Réception d’événements à tout moment

Partager via