Función EvtCreateBookmark (winevt.h)
Crea un marcador que identifica un evento en un canal.
Sintaxis
EVT_HANDLE EvtCreateBookmark(
[in, optional] LPCWSTR BookmarkXml
);
Parámetros
[in, optional] BookmarkXml
Cadena XML que contiene el marcador o NULL si crea un marcador.
Valor devuelto
Identificador del marcador si la llamada se realiza correctamente; en caso contrario, NULL. Si es NULL, llame a la función GetLastError para obtener el código de error.
Comentarios
Para crear un marcador, establezca el parámetro BookmarkXml en NULL. Antes de salir, llame a la función EvtUpdateBookmark para actualizar el marcador. Pase el identificador de marcador a la función EvtRender para representar el marcador como una cadena XML. A continuación, puede conservar la cadena para usarla más adelante. Para empezar a consumir eventos desde donde dejó la última vez, establezca BookmarkXml en la cadena XML que conserva. Para una suscripción, pase el identificador de marcador a la función EvtSubscribe . Para una consulta, pase el identificador de marcador a la función EvtSeek para buscar un evento específico en el resultado de la consulta.
Si la consulta está en varios canales, el identificador de marcador contendrá marcadores para cada canal. No se puede crear un marcador para un archivo de registro.
Debe llamar a la función EvtClose para cerrar el identificador cuando haya terminado.
Ejemplos
Para obtener un ejemplo en el que se muestra cómo usar esta función, vea Bookmarking Events.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winevt.h |
| Library | Wevtapi.lib |
| Archivo DLL | Wevtapi.dll |