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 |