EVT_SEEK_FLAGS列舉 (winevt.h)

  • 發行項

定義結果集中要從中搜尋的相對位置。

Syntax

typedef enum _EVT_SEEK_FLAGS {
  EvtSeekRelativeToFirst = 1,
  EvtSeekRelativeToLast = 2,
  EvtSeekRelativeToCurrent = 3,
  EvtSeekRelativeToBookmark = 4,
  EvtSeekOriginMask = 7,
  EvtSeekStrict = 0x10000
} EVT_SEEK_FLAGS;

常數

 
EvtSeekRelativeToFirst
值： 1
搜尋結果集中第一個專案的指定位移。 位移必須是正值。
EvtSeekRelativeToLast
值： 2
搜尋結果集中最後一個專案的指定位移。 位移必須是負值。
EvtSeekRelativeToCurrent
值： 3
搜尋結果集中目前專案的指定位移。 位移可以是正值或負值。
EvtSeekRelativeToBookmark
值： 4
從結果集中的書籤項目搜尋指定的位移。 位移可以是正值或負值。
EvtSeekOriginMask
值： 7
可用來判斷下列哪一個旗標已設定的位掩碼：


  • EvtSeekRelativeToFirst

  • EvtSeekRelativeToLast

  • EvtSeekRelativeToBookmark
EvtSeekStrict
值： 0x10000
如果事件不存在，強制函式失敗。

備註

如果位移或書籤搜尋超過結果集的界限 (超過第一筆或最後一筆記錄) ，且未設定 EvtSeekStrict，則 seek 會傳回界限內的最後一筆記錄。

如果書籤位於結果集的界限內， (根據事件記錄標識碼) 但不包含在結果集中，則 seek 函式會套用相對於書籤記錄標識符的位移。 在下表中，第一個數據行會顯示結果集中事件的記錄標識碼。 如果書籤的記錄標識碼為 3989，則第二個數據行會顯示搜尋函式會搜尋指定的位移的記錄。

記錄識別碼 Offset
3995 –2
3991 –1
3987 0, 1
3983 2
3979 3
3975 4
3971 5
3968 6
3959 7
3955 8

規格需求

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

另請參閱

EvtSeek