enumerazione EVT_SUBSCRIBE_FLAGS (winevt.h)

Articolo
03/09/2024

Definisce i valori possibili che specificano quando avviare la sottoscrizione agli eventi.

Sintassi

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

Costanti


`EvtSubscribeToFutureEvents` Valore: 1 Sottoscrivere solo eventi futuri che corrispondono ai criteri di query.
`EvtSubscribeStartAtOldestRecord` Valore: 2 Sottoscrivere tutti gli eventi esistenti e futuri che corrispondono ai criteri di query.
`EvtSubscribeStartAfterBookmark` Valore: 3 Sottoscrivere tutti gli eventi esistenti e futuri che corrispondono ai criteri di query che iniziano dopo l'evento segnalibro. Se si include il flag EvtSubscribeStrict, la funzione EvtSubscribe ha esito negativo se l'evento segnalibro non esiste. Se non si include il flag EvtSubscribeStrict e l'evento segnalibro non esiste, la sottoscrizione inizia con l'evento dopo l'evento più vicino all'evento segnalibro.
`EvtSubscribeOriginMask` Valore: 3 Maschera di bit che è possibile usare per determinare quale dei flag seguenti è impostato: EvtSubscribeToFutureEvents EvtSubscribeStartAtOldestRecord EvtSubscribeStartAfterBookmark
`EvtSubscribeTolerateQueryErrors` Valore: 0x1000 Completare la sottoscrizione anche se la parte della query genera un errore (non è ben formato). Il servizio convalida la sintassi della query XPath per determinare se è ben formato. Se la convalida ha esito negativo, il servizio analizza XPath in singole espressioni. Compila un nuovo XPath a partire dall'espressione più sinistra. Il servizio convalida l'espressione e, se è valida, il servizio aggiunge l'espressione successiva a XPath. Il servizio ripete questo processo finché non trova l'espressione che ha esito negativo. Usa quindi le espressioni valide che si trovano a partire dall'espressione più a sinistra come query XPath, che significa che non è possibile ottenere gli eventi previsti. Se non è valida alcuna parte di XPath, la chiamata EvtSubscribe ha esito negativo.
`EvtSubscribeStrict` Valore: 0x10000 Forza la chiamata EvtSubscribe a non riuscire se si specifica EvtSubscribeStartAfterBookmark e l'evento segnalibro non viene trovato (il valore restituito è ERROR_NOT_FOUND). Impostare anche questo flag se si vuole ricevere una notifica nel callback quando mancano i record di eventi.

Commenti

I flag EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord e EvtSubscribeStartAfterBookmark sono reciprocamente esclusivi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	winevt.h

Vedi anche

EvtSubscribe

Condividi tramite