Funzione EvtCreateBookmark (winevt.h)

Crea un segnalibro che identifica un evento in un canale.

Sintassi

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

Parametri

[in, optional] BookmarkXml

Stringa XML che contiene il segnalibro o NULL se si crea un segnalibro.

Valore restituito

Handle al segnalibro se la chiamata ha esito positivo; in caso contrario, NULL. Se NULL, chiamare la funzione GetLastError per ottenere il codice di errore.

Commenti

Per creare un segnalibro, impostare il parametro BookmarkXml su NULL. Prima di uscire, chiamare la funzione EvtUpdateBookmark per aggiornare il segnalibro. Passare l'handle di segnalibro alla funzione EvtRender per eseguire il rendering del segnalibro come stringa XML. È quindi possibile salvare in modo permanente la stringa da usare in un secondo momento. Per iniziare a utilizzare gli eventi da cui è stata interrotta l'ultima volta, impostare BookmarkXml sulla stringa XML persistente. Per una sottoscrizione, passare l'handle di segnalibro alla funzione EvtSubscribe . Per una query, passare l'handle di segnalibro alla funzione EvtSeek per cercare un evento specifico nel risultato della query.

Se la query viene eseguita su più canali, l'handle di segnalibro conterrà segnalibri per ogni canale. Non è possibile creare un segnalibro per un file di log.

Al termine, è necessario chiamare la funzione EvtClose per chiudere l'handle.

Esempio

Per un esempio che illustra come usare questa funzione, vedere Bookmarking Events .For an example that shows how to use this function, see Bookmarking Events.

Requisiti

Vedi anche

EvtUpdateBookmark