EVT_SUBSCRIBE_FLAGS列挙 (winevt.h)

  • [アーティクル]

イベントのサブスクライブを開始するタイミングを指定する使用可能な値を定義します。

構文

typedef enum _EVT_SUBSCRIBE_FLAGS {
  EvtSubscribeToFutureEvents = 1,
  EvtSubscribeStartAtOldestRecord = 2,
  EvtSubscribeStartAfterBookmark = 3,
  EvtSubscribeOriginMask = 3,
  EvtSubscribeTolerateQueryErrors = 0x1000,
  EvtSubscribeStrict = 0x10000
} EVT_SUBSCRIBE_FLAGS;

定数

 
EvtSubscribeToFutureEvents
値: 1
クエリ条件に一致する今後のイベントのみをサブスクライブします。
EvtSubscribeStartAtOldestRecord
値: 2
クエリ条件に一致するすべての既存および将来のイベントをサブスクライブします。
EvtSubscribeStartAfterBookmark
値: 3
ブックマークされたイベントの後に始まるクエリ条件に一致するすべての既存および将来のイベントをサブスクライブします。 EvtSubscribeStrict フラグを含める場合、ブックマークされたイベントが存在しない場合、 EvtSubscribe 関数は失敗します。 EvtSubscribeStrict フラグを含めず、ブックマークされたイベントが存在しない場合、サブスクリプションは、ブックマークされたイベントに最も近いイベントの後にあるイベントで始まります。
EvtSubscribeOriginMask
値: 3
次のフラグのうちどれが設定されているかを判断するために使用できるビットマスク。


  • EvtSubscribeToFutureEvents

  • EvtSubscribeStartAtOldestRecord

  • EvtSubscribeStartAfterBookmark
EvtSubscribeTolerateQueryErrors
値: 0x1000
クエリの一部でエラーが発生した (適切な形式ではない) 場合でも、サブスクリプションを完了します。 サービスは XPath クエリの構文を検証して、整形式かどうかを判断します。 検証が失敗した場合、サービスは XPath を個々の式に解析します。 これは、左端の式で始まる新しい XPath を構築します。 サービスは式を検証し、有効な場合は、次の式を XPath に追加します。 サービスは、失敗している式が見つかるまで、このプロセスを繰り返します。 次に、左端の式で始まる有効な式を XPath クエリとして使用します (これは、予期したイベントを取得できない可能性があることを意味します)。 XPath の一部が有効でない場合、 EvtSubscribe 呼び出しは失敗します。
EvtSubscribeStrict
値: 0x10000
EvtSubscribeStartAfterBookmark を指定し、ブックマークされたイベントが見つからない (戻り値がERROR_NOT_FOUND) 場合、EvtSubscribe 呼び出しが強制的に失敗します。 また、イベント レコードが見つからないときにコールバックで通知を受信する場合は、このフラグを設定します。

注釈

EvtSubscribeToFutureEvents、EvtSubscribeStartAtOldestRecord、EvtSubscribeStartAfterBookmark フラグは相互に排他的です。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header winevt.h

こちらもご覧ください

EvtSubscribe