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 函式，才能在完成時關閉句柄。

範例

如需示範如何使用此函式的範例，請參閱 將事件加入書籤。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	winevt.h
程式庫	Wevtapi.lib
Dll	Wevtapi.dll

另請參閱

EvtUpdateBookmark