Função EvtCreateBookmark (winevt.h)

Cria um indicador que identifica um evento em um canal.

Sintaxe

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

Parâmetros

[in, optional] BookmarkXml

Uma cadeia de caracteres XML que contém o indicador ou NULL ao criar um indicador.

Retornar valor

Um identificador para o indicador se a chamada for bem-sucedida; caso contrário, NULL. Se FOR NULL, chame a função GetLastError para obter o código de erro.

Comentários

Para criar um indicador, defina o parâmetro BookmarkXml como NULL. Antes de sair, chame a função EvtUpdateBookmark para atualizar o indicador. Passe o identificador de indicador para a função EvtRender para renderizar o indicador como uma cadeia de caracteres XML. Em seguida, você pode persistir a cadeia de caracteres para uso posterior. Para começar a consumir eventos de onde você parou da última vez, defina BookmarkXml como a cadeia de caracteres XML que você persistiu. Para uma assinatura, passe o identificador de indicador para a função EvtSubscribe . Para uma consulta, passe o identificador de indicador para a função EvtSeek para buscar um evento específico no resultado da consulta.

Se a consulta estiver em vários canais, o identificador de indicador conterá indicadores para cada canal. Você não pode criar um indicador para um arquivo de log.

Você deve chamar a função EvtClose para fechar o identificador quando terminar.

Exemplos

Para obter um exemplo que mostra como usar essa função, consulte Eventos de indicadores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winevt.h
Biblioteca	Wevtapi.lib
DLL	Wevtapi.dll

Confira também

EvtUpdateBookmark