EvtCreateBookmark 関数 (winevt.h)

チャネル内のイベントを識別するブックマークを作成します。

構文

EVT_HANDLE EvtCreateBookmark(
  [in, optional] LPCWSTR BookmarkXml
);

パラメーター

[in, optional] BookmarkXml

ブックマークを含む XML 文字列。ブックマークを作成する場合は NULL 。

戻り値

呼び出しが成功した場合のブックマークへのハンドル。それ以外の場合は NULL。 NULL の場合は、GetLastError 関数を呼び出してエラー コードを取得します。

注釈

ブックマークを作成するには、 BookmarkXml パラメーターを NULL に設定 します。 終了する前に、 EvtUpdateBookmark 関数を呼び出してブックマークを更新します。 ブックマーク ハンドルを EvtRender 関数に渡して、ブックマークを XML 文字列としてレンダリングします。 その後、後で使用するために文字列を永続化できます。 前回中断したイベントの使用を開始するには、 BookmarkXml を永続化した XML 文字列に設定します。 サブスクリプションの場合は、ブックマーク ハンドルを EvtSubscribe 関数に渡します。 クエリの場合は、ブックマーク ハンドルを EvtSeek 関数に渡して、クエリ結果の特定のイベントをシークします。

クエリが複数のチャネルに対する場合、ブックマーク ハンドルには各チャネルのブックマークが含まれます。 ログ ファイルのブックマークを作成することはできません。

完了したら、 EvtClose 関数を呼び出してハンドルを閉じる必要があります。

例

この関数の使用方法を示す例については、「 イベントのブックマーク」を参照してください。

要件

こちらもご覧ください

EvtUpdateBookmark