SMTPEventConsumer クラス

SMTPEventConsumer クラスは、イベントが届くたびに、簡易メール転送プロトコル (SMTP) を使用して電子メール メッセージを送信します。 SMTP サーバーはネットワーク上に存在する必要があります。 SMTPEventConsumer クラスは添付ファイルをサポートしていません。 電子メール メッセージのエンコードは US-ASCII である必要があります。

このクラスは、WMI に用意されている標準イベント コンシューマーの 1 つです。 SMTPEventConsumer を使用してコンシューマーを作成する例については、「イベントに基づいて Email を送信する」を参照してください。 詳細については、「標準コンシューマーを使用したイベントの監視と対応」を参照してください。

次の構文は Managed Object Format (MOF) のコードを単純化したもので、そのすべての継承されたプロパティを含みます。 プロパティとメソッドはアルファベット順であり、MOF 順ではありません。

構文

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

メンバー

SMTPEventConsumer クラスには、次の種類のメンバーがあります。

プロパティ

SMTPEventConsumer クラスには、次のプロパティがあります。

BccLine

データ型: string

アクセスの種類: 読み取り専用

メッセージがブラインド カーボン コピーとして送信される標準の文字列テンプレートの形式で、コンマまたはセミコロンで区切られたアドレスの一覧。 詳細については、このトピックの「解説」セクションを参照してください。

CcLine

データ型: string

アクセスの種類: 読み取り専用

メッセージがカーボン コピーとして送信される標準の文字列テンプレートの形式で、コンマまたはセミコロンで区切られたアドレスの一覧。 詳細については、このトピックの「解説」セクションを参照してください。

CreatorSID

データ型: uint8 配列

アクセスの種類: 読み取り専用

フィルターを作成するユーザーを一意に識別するセキュリティ識別子 (SID)。 WMI では、オペレーティング システムに応じて、__EventConsumer のインスタンスを作成するユーザーの SID、または管理者の SID が格納されます。 詳細については、「論理コンシューマーを使用してイベント フィルターをバインドする」と「標準コンシューマーを使用したイベントの監視と対応」を参照してください。

このプロパティは、__EventConsumer から継承されます。

FromLine

データ型: string

アクセスの種類: 読み取り専用

標準の文字列テンプレートの形式の電子メール メッセージの [差出人] 行。 NULL の場合、[差出人] 行は "WinMgmt@MachineName" の形式で作成されます。

HeaderFields

データ型: string 配列

アクセスの種類: 読み取り専用

解釈なしで電子メール メッセージに挿入されるヘッダー フィールドの配列。

MachineName

データ型: string

アクセスの種類: 読み取り専用

Windows Management Instrumentation (WMI) がイベントを送信するコンピューターの名前。

このプロパティは、__EventConsumer から継承されます。

MaximumQueueSize

データ型: uint32

アクセスの種類: 読み取り専用

特定のコンシューマーの最大キュー (バイト単位)。

このプロパティは、__EventConsumer から継承されます。

メッセージ

データ型: string

アクセスの種類: 読み取り専用

電子メール メッセージの本文を含む標準の文字列テンプレート。

名前

データ型: string

アクセスの種類: 読み取り専用

修飾子: Key

イベント コンシューマーの一意識別子。

ReplyToLine

データ型: string

アクセスの種類: 読み取り専用

標準の文字列テンプレートの形式の電子メール メッセージの [返信先] 行。 NULL の場合、[返信先] 行は使用されません。

SMTPServer

データ型: string

アクセスの種類: 読み取り専用

電子メールが送信される SMTP サーバーの名前。 使用できる名前は、IP アドレス、または DNS または NetBIOS 名です。 このプロパティを NULL にすることはできません。

件名

データ型: string

アクセスの種類: 読み取り専用

電子メール メッセージの件名を含む標準の文字列テンプレート。

ToLine

データ型: string

アクセスの種類: 読み取り専用

メッセージの送信先を識別する標準の文字列テンプレートの形式で、コンマまたはセミコロンで区切られたアドレスの一覧。 詳細については、このトピックの「解説」セクションを参照してください。

解説

SMTPEventConsumer クラスは、__EventConsumer 抽象クラスから派生したものです。

ToLine、CcLine、または BccLine プロパティの一部は NULL にできますが、すべてを NULL にすることはできません。

SMTP サービスからのエラー リターン コードを受信した場合は失敗と見なされます。

例

SMTPEventConsumer を使用してコンシューマーを作成する例については、「イベントに基づいて Email を送信する」を参照してください。 詳細については、「標準コンシューマーを使用したイベントの監視と対応」を参照してください。

要件

要件 値
サポートされている最小のクライアント
Windows Vista
サポートされている最小のサーバー
Windows Server 2008
名前空間
Root\subscription
MOF
Smtpcons.mof
[DLL]
Smtpcons.mof

関連項目

__EventConsumer

標準コンシューマー クラス

イベントに基づいて Email を送信する

論理コンシューマーの作成

常にイベントを受信する