Windows Dev Center

EVT_SEEK_FLAGS enumeration

Defines the relative position in the result set from which to seek.

Syntax


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

Constants

EvtSeekRelativeToFirst

Seek to the specified offset from the first entry in the result set. The offset must be a positive value.

EvtSeekRelativeToLast

Seek to the specified offset from the last entry in the result set. The offset must be a negative value.

EvtSeekRelativeToCurrent

Seek to the specified offset from the current entry in the result set. The offset can be a positive or negative value.

EvtSeekRelativeToBookmark

Seek to the specified offset from the bookmarked entry in the result set. The offset can be a positive or negative value.

EvtSeekOriginMask

A bitmask that you can use to determine which of the following flags is set:

  • EvtSeekRelativeToFirst
  • EvtSeekRelativeToLast
  • EvtSeekRelativeToBookmark
EvtSeekStrict

Force the function to fail if the event does not exist.

Remarks

If the offset or bookmark seeks past the boundary of the result set (past the first or last record), and EvtSeekStrict is not set, seek will return the last record within the boundary.

If the bookmark is within the boundaries of the result set (based on event record ID) but is not included in the result set, the seek function will apply the offset relative to the bookmark's record ID. In the following table, the first column shows the record IDs of the events in the result set. If the bookmark's record ID is 3989, the second column shows the record that the seek function would seek to given the specified offset.

Record IDOffset
3995–2
3991–1
39870, 1
39832
39793
39754
39715
39686
39597
39558

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

WinEvt.h

See also

EvtSeek

 

 

Community Additions

ADD
Show:
© 2015 Microsoft