EVT_SEEK_FLAGS 枚举 (winevt.h)

  • 项目

定义要从中查找的结果集中的相对位置。

语法

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 将返回边界内的最后一条记录。

如果书签位于基于事件记录 ID) 的结果集 (边界内，但不包含在结果集中，则 seek 函数将应用相对于书签的记录 ID 的偏移量。 在下表中，第一列显示结果集中事件的记录 ID。 如果书签的记录 ID 为 3989，则第二列显示 seek 函数在给定指定偏移量时将查找的记录。

记录 ID 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