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 次のフラグのうちどれが設定されているかを判断するために使用できるビットマスク。
|
EvtSeekStrict 値: 0x10000 イベントが存在しない場合は、関数を強制的に失敗させます。 |
注釈
オフセットまたはブックマークが結果セットの境界 (最初または最後のレコードを超えて) をシークし、EvtSeekStrict が設定されていない場合、seek は境界内の最後のレコードを返します。
ブックマークが (イベント レコード ID に基づいて) 結果セットの境界内にあり、結果セットに含まれていない場合、seek 関数はブックマークのレコード ID を基準にオフセットを適用します。 次の表の最初の列は、結果セット内のイベントのレコード ID を示しています。 ブックマークのレコード ID が 3989 の場合、2 番目の列には、seek 関数が指定したオフセットを指定してシークするレコードが表示されます。
Record ID (レコード 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 [デスクトップ アプリのみ] |
Header | winevt.h |