enumeración EVT_SUBSCRIBE_FLAGS (winevt.h)

Define los valores posibles que especifican cuándo empezar a suscribirse a eventos.

Syntax

typedef enum _EVT_SUBSCRIBE_FLAGS {
  EvtSubscribeToFutureEvents = 1,
  EvtSubscribeStartAtOldestRecord = 2,
  EvtSubscribeStartAfterBookmark = 3,
  EvtSubscribeOriginMask = 3,
  EvtSubscribeTolerateQueryErrors = 0x1000,
  EvtSubscribeStrict = 0x10000
} EVT_SUBSCRIBE_FLAGS;

Constantes

EvtSubscribeToFutureEvents Valor: 1 Suscríbase solo a eventos futuros que coincidan con los criterios de consulta.
EvtSubscribeStartAtOldestRecord Valor: 2 Suscríbase a todos los eventos existentes y futuros que coincidan con los criterios de consulta.
EvtSubscribeStartAfterBookmark Valor: 3 Suscríbase a todos los eventos existentes y futuros que coincidan con los criterios de consulta que comienzan después del evento marcado. Si incluye la marca EvtSubscribeStrict, se produce un error en la función EvtSubscribe si el evento marcado no existe. Si no incluye la marca EvtSubscribeStrict y el evento marcado no existe, la suscripción comienza con el evento que es posterior al evento más cercano al evento marcado.
EvtSubscribeOriginMask Valor: 3 Máscara de bits que puede usar para determinar cuál de las marcas siguientes está establecida: EvtSubscribeToFutureEvents EvtSubscribeStartAtOldestRecord EvtSubscribeStartAfterBookmark
EvtSubscribeTolerateQueryErrors Valor: 0x1000 Complete la suscripción incluso si la parte de la consulta genera un error (no tiene el formato correcto). El servicio valida la sintaxis de la consulta XPath para determinar si está bien formado. Si se produce un error en la validación, el servicio analiza XPath en expresiones individuales. Crea un nuevo XPath a partir de la expresión izquierda. El servicio valida la expresión y, si es válida, el servicio agrega la siguiente expresión a XPath. El servicio repite este proceso hasta que encuentra la expresión con errores. A continuación, usa las expresiones válidas que encontró a partir de la expresión situada más a la izquierda como consulta XPath (lo que significa que es posible que no obtenga los eventos esperados). Si ninguna parte de XPath es válida, se produce un error en la llamada a EvtSubscribe .
EvtSubscribeStrict Valor: 0x10000 Fuerza que la llamada a EvtSubscribe produzca un error si especifica EvtSubscribeStartAfterBookmark y no se encuentra el evento marcado (el valor devuelto es ERROR_NOT_FOUND). Además, establezca esta marca si desea recibir notificaciones en la devolución de llamada cuando faltan registros de eventos.

Comentarios

Las marcas EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord y EvtSubscribeStartAfterBookmark son mutuamente excluyentes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	winevt.h

Consulte también

EvtSubscribe