NTEventLogEventConsumer クラス
NTEventLogEventConsumer クラスは、イベントが配信されると、特定のメッセージをオペレーティング システムのイベント ログに記録します。 このクラスは、WMI に用意されている標準イベント コンシューマーの 1 つです。 詳細については、「標準コンシューマーを使用したイベントの監視と対応」を参照してください。
構文
[AMENDMENT]
class NTEventLogEventConsumer : __EventConsumer
{
uint8 CreatorSID[];
string MachineName;
uint32 MaximumQueueSize;
uint16 Category;
string NameOfRawDataProperty;
uint32 EventID;
uint32 EventType = 1;
string InsertionStringTemplates[] = {""};
string Name;
uint32 NumberOfInsertionStrings = 0;
string NameOfUserSidProperty;
string SourceName;
string UNCServerName;
};
メンバー
NTEventLogEventConsumer クラスには、次の種類のメンバーがあります。
プロパティ
NTEventLogEventConsumer クラスには、次のプロパティがあります。
-
カテゴリ
-
-
データ型: uint16
-
アクセスの種類: 読み取り専用
イベント カテゴリ。 これはソース固有の情報であり、あらゆる値になりえます。
-
-
CreatorSID
-
-
データ型: uint8 配列
-
アクセスの種類: 読み取り専用
フィルターを作成するユーザーを一意に識別するセキュリティ識別子 (SID)。 WMI では、オペレーティング システムに応じて、__EventConsumer のインスタンスを作成するユーザーの SID、または管理者の SID が格納されます。 詳細については、「論理コンシューマーを使用してイベント フィルターをバインドする」と「標準コンシューマーを使用したイベントの監視と対応」を参照してください。
このプロパティは、__EventConsumer から継承されます。
-
-
イベント ID
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
メッセージ DLL 内のイベント メッセージ。 このプロパティを NULL にすることはできません。
-
-
EventType
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
イベントの種類。 このパラメーターには、次の一覧に記載されている、Winnt.h で定義された値のいずれかを指定できます。
-
-
EVENTLOG_SUCCESS (0 (0x0))
-
成功イベント
-
EVENTLOG_ERROR_TPYE (1 (0x1))
-
エラー イベント
-
EVENTLOG_WARNING_TYPE (2 (0x2))
-
警告イベント
-
EVENTLOG_INFORMATION_TYPE (4 (0x4))
-
情報イベント
-
EVENTLOG_AUDIT_SUCCESS (8 (0x8))
-
成功監査の種類
-
EVENTLOG_AUDIT_FAILURE (16 (0x10))
-
失敗監査の種類
InsertionStringTemplates
-
データ型: string 配列
-
アクセスの種類: 読み取り専用
イベント ログ レコードの挿入文字列として使用される標準の文字列テンプレートの配列。
MachineName
-
データ型: string
-
アクセスの種類: 読み取り専用
Windows Management Instrumentation (WMI) がイベントを送信するコンピューターの名前。
このプロパティは、__EventConsumer から継承されます。
MaximumQueueSize
-
データ型: uint32
-
アクセスの種類: 読み取り専用
特定のコンシューマーの最大キュー (バイト単位)。
このプロパティは、__EventConsumer から継承されます。
名前
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: Key
コンシューマーの一意の名前。
NameOfRawDataProperty
-
データ型: string
-
アクセスの種類: 読み取り専用
ReportEvent 関数 lpRawData パラメーターに渡されるデータを含む、イベント プロパティの名前。
NameOfUserSidProperty
-
データ型: string
-
アクセスの種類: 読み取り専用
ReportEvent 関数 lpUserSid パラメーターに渡されるセキュリティ識別子 (SID) を含む、イベント プロパティの名前。 プロパティは、バイト配列 (uint8) または文字列である必要があります。 バイト配列の場合は、SID と見なされます。 文字列の場合は、SID に変換される文字列 SID です。
NumberOfInsertionStrings
-
データ型: uint32
-
アクセスの種類: 読み取り専用
InsertionStringTemplates 配列内の要素の数。
[SourceName]
-
データ型: string
-
アクセスの種類: 読み取り専用
メッセージが置かれているソース名。 お客様は、必要なメッセージに DLL を登録したと見なされます。
注意
このパラメーターの値にはコロン (:) 文字を使用してはなりません。
UNCServerName
-
データ型: string
-
アクセスの種類: 読み取り専用
イベントをログに記録するコンピューターの名前。イベントがローカル サーバーに記録される場合は NULL。
認証済みユーザーは、既定では、リモート コンピューター上のアプリケーション ログにイベントを記録できません。 その結果として、このプロパティを使用してリモート コンピューターを指定しても機能しません。 イベント ログのセキュリティを変更する方法については、こちらのサポート技術情報の記事を参照してください。
解説
NTEventLogEventConsumer クラスは、__EventConsumer 抽象クラスから派生したものです。
例
NTEventLogEventConsumer を使用してコンシューマーを作成する例については、「イベントに基づいて NT イベント ログに記録する」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
名前空間 |
Root\subscription |
MOF |
|
[DLL] |
|