ホーム › System.EventLog › EVT_SUBSCRIBE_FLAGS

EVT_SUBSCRIBE_FLAGS

列挙型

基底型u4

メンバー 6

名前	10進	16進	説明
EvtSubscribeToFutureEvents	1	0x1	クエリ条件に一致する将来のイベントのみをサブスクライブします。
EvtSubscribeStartAtOldestRecord	2	0x2	クエリ条件に一致する既存および将来のすべてのイベントをサブスクライブします。
EvtSubscribeStartAfterBookmark	3	0x3	クエリ条件に一致し、ブックマークされたイベントより後に発生する既存および将来のすべてのイベントをサブスクライブします。EvtSubscribeStrict フラグを指定した場合、ブックマークされたイベントが存在しないと EvtSubscribe 関数は失敗します。EvtSubscribeStrict フラグを指定せず、ブックマークされたイベントが存在しない場合、サブスクリプションは、ブックマークされたイベントに最も近いイベントの次のイベントから開始されます。
EvtSubscribeOriginMask	3	0x3	次のうちどのフラグが設定されているかを判別するために使用できるビットマスクです。 EvtSubscribeToFutureEvents EvtSubscribeStartAtOldestRecord EvtSubscribeStartAfterBookmark
EvtSubscribeTolerateQueryErrors	4096	0x1000	クエリの一部がエラーを発生させる (整形式でない) 場合でも、サブスクリプションを完了します。サービスは XPath クエリの構文を検証して、整形式かどうかを判断します。検証に失敗した場合、サービスは XPath を個々の式に分解します。そして、最も左側の式から始めて新しい XPath を構築します。サービスはその式を検証し、有効であれば次の式を XPath に追加します。サービスは、失敗する式が見つかるまでこの処理を繰り返します。その後、最も左側の式から始まる有効な式の部分を XPath クエリとして使用します (このため、期待したイベントが取得できない場合があります)。XPath のどの部分も有効でない場合、EvtSubscribe の呼び出しは失敗します。
EvtSubscribeStrict	65536	0x10000	EvtSubscribeStartAfterBookmark を指定し、ブックマークされたイベントが見つからない場合に、EvtSubscribe の呼び出しを強制的に失敗させます (戻り値は ERROR_NOT_FOUND です)。また、イベントレコードが欠落している場合にコールバックで通知を受け取りたいときにも、このフラグを設定します。

公式ドキュメント

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum EVT_SUBSCRIBE_FLAGS : unsigned int {
    EvtSubscribeToFutureEvents = 1,
    EvtSubscribeStartAtOldestRecord = 2,
    EvtSubscribeStartAfterBookmark = 3,
    EvtSubscribeOriginMask = 3,
    EvtSubscribeTolerateQueryErrors = 4096,
    EvtSubscribeStrict = 65536
} EVT_SUBSCRIBE_FLAGS;

public enum EVT_SUBSCRIBE_FLAGS : uint
{
    EvtSubscribeToFutureEvents = 1,
    EvtSubscribeStartAtOldestRecord = 2,
    EvtSubscribeStartAfterBookmark = 3,
    EvtSubscribeOriginMask = 3,
    EvtSubscribeTolerateQueryErrors = 4096,
    EvtSubscribeStrict = 65536,
}

Public Enum EVT_SUBSCRIBE_FLAGS As UInteger
    EvtSubscribeToFutureEvents = 1
    EvtSubscribeStartAtOldestRecord = 2
    EvtSubscribeStartAfterBookmark = 3
    EvtSubscribeOriginMask = 3
    EvtSubscribeTolerateQueryErrors = 4096
    EvtSubscribeStrict = 65536
End Enum

import enum

class EVT_SUBSCRIBE_FLAGS(enum.IntEnum):
    EvtSubscribeToFutureEvents = 1
    EvtSubscribeStartAtOldestRecord = 2
    EvtSubscribeStartAfterBookmark = 3
    EvtSubscribeOriginMask = 3
    EvtSubscribeTolerateQueryErrors = 4096
    EvtSubscribeStrict = 65536

// EVT_SUBSCRIBE_FLAGS
pub const EvtSubscribeToFutureEvents: u32 = 1;
pub const EvtSubscribeStartAtOldestRecord: u32 = 2;
pub const EvtSubscribeStartAfterBookmark: u32 = 3;
pub const EvtSubscribeOriginMask: u32 = 3;
pub const EvtSubscribeTolerateQueryErrors: u32 = 4096;
pub const EvtSubscribeStrict: u32 = 65536;

// EVT_SUBSCRIBE_FLAGS
const (
	EvtSubscribeToFutureEvents uint32 = 1
	EvtSubscribeStartAtOldestRecord uint32 = 2
	EvtSubscribeStartAfterBookmark uint32 = 3
	EvtSubscribeOriginMask uint32 = 3
	EvtSubscribeTolerateQueryErrors uint32 = 4096
	EvtSubscribeStrict uint32 = 65536
)

const
  EvtSubscribeToFutureEvents = 1;
  EvtSubscribeStartAtOldestRecord = 2;
  EvtSubscribeStartAfterBookmark = 3;
  EvtSubscribeOriginMask = 3;
  EvtSubscribeTolerateQueryErrors = 4096;
  EvtSubscribeStrict = 65536;

// EVT_SUBSCRIBE_FLAGS
pub const EvtSubscribeToFutureEvents: u32 = 1;
pub const EvtSubscribeStartAtOldestRecord: u32 = 2;
pub const EvtSubscribeStartAfterBookmark: u32 = 3;
pub const EvtSubscribeOriginMask: u32 = 3;
pub const EvtSubscribeTolerateQueryErrors: u32 = 4096;
pub const EvtSubscribeStrict: u32 = 65536;

const
  EvtSubscribeToFutureEvents* = 1
  EvtSubscribeStartAtOldestRecord* = 2
  EvtSubscribeStartAfterBookmark* = 3
  EvtSubscribeOriginMask* = 3
  EvtSubscribeTolerateQueryErrors* = 4096
  EvtSubscribeStrict* = 65536

enum EVT_SUBSCRIBE_FLAGS : uint {
    EvtSubscribeToFutureEvents = 1,
    EvtSubscribeStartAtOldestRecord = 2,
    EvtSubscribeStartAfterBookmark = 3,
    EvtSubscribeOriginMask = 3,
    EvtSubscribeTolerateQueryErrors = 4096,
    EvtSubscribeStrict = 65536,
}

#define global EvtSubscribeToFutureEvents      0x1
#define global EvtSubscribeStartAtOldestRecord 0x2
#define global EvtSubscribeStartAfterBookmark  0x3
#define global EvtSubscribeOriginMask          0x3
#define global EvtSubscribeTolerateQueryErrors 0x1000
#define global EvtSubscribeStrict              0x10000