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

Consulte también

EvtUpdateBookmark