共用方式為

EVT_SUBSCRIBE_FLAGS (winevt.h) 列舉

  • 發行項

定義可能的值，指定何時開始訂閱事件。

Syntax

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 且找不到書籤事件，則強制 EvtSubscribe 呼叫失敗， (傳回值ERROR_NOT_FOUND) 。 此外，如果您想要在遺漏事件記錄時收到回呼中的通知，請設定此旗標。

備註

EvtSubscribeToFutureEvents、EvtSubscribeStartAtOldestRecord 和 EvtSubscribeStartAfterBookmark 旗標互斥。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 winevt.h

另請參閱

EvtSubscribe