EvtSeek 関数 (winevt.h)

クエリ結果セット内の特定のイベントをシークします。

構文

BOOL EvtSeek(
  [in] EVT_HANDLE ResultSet,
  [in] LONGLONG   Position,
  [in] EVT_HANDLE Bookmark,
  [in] DWORD      Timeout,
  [in] DWORD      Flags
);

パラメーター

[in] ResultSet

EvtQuery 関数が返すクエリ結果セットへのハンドル。

[in] Position

結果セット内のイベントへの 0 から始まるオフセット。 Flags パラメーターで指定するフラグは、シーク元の結果セット内の開始相対位置を示します。 たとえば、結果の先頭から、または結果の末尾からシークできます。 フラグで指定された相対位置に移動するには、0 に設定します。

[in] Bookmark

EvtCreateBookmark 関数が返すブックマークへのハンドル。 ブックマークは、シーク先の結果セット内のイベントを識別します。 Flags パラメーターに EvtSeekRelativeToBookmark フラグが設定されている場合にのみ、このパラメーターを設定します。

[in] Timeout

予約済み。 ゼロを指定してください。

[in] Flags

シーク元の結果セット内の相対位置を示す 1 つ以上のフラグ。 使用可能な値については、 EVT_SEEK_FLAGS 列挙を参照してください。

戻り値

注釈

この関数は、管理または運用チャネル、または .evtx ログ ファイルからの結果セットでのみ使用できます。

例

この関数の使用方法を示す例については、「 Bookmarking Events」を参照してください。

要件

こちらもご覧ください

EvtNext

EvtQuery