énumération EVT_SUBSCRIBE_FLAGS (winevt.h)

Article
03/04/2024

Définit les valeurs possibles qui spécifient quand commencer à s’abonner aux événements.

Syntax

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

Constantes


`EvtSubscribeToFutureEvents` Valeur : 1 Abonnez-vous uniquement aux événements futurs qui correspondent aux critères de requête.
`EvtSubscribeStartAtOldestRecord` Valeur : 2 Abonnez-vous à tous les événements existants et futurs qui correspondent aux critères de requête.
`EvtSubscribeStartAfterBookmark` Valeur : 3 Abonnez-vous à tous les événements existants et futurs qui correspondent aux critères de requête qui commencent après l’événement marqué d’un signet. Si vous incluez l’indicateur EvtSubscribeStrict, la fonction EvtSubscribe échoue si l’événement marqué d’un signet n’existe pas. Si vous n’incluez pas l’indicateur EvtSubscribeStrict et que l’événement marqué d’un signet n’existe pas, l’abonnement commence par l’événement qui se trouve après l’événement le plus proche de l’événement marqué d’un signet.
`EvtSubscribeOriginMask` Valeur : 3 Masque de bits que vous pouvez utiliser pour déterminer lequel des indicateurs suivants est défini : EvtSubscribeToFutureEvents EvtSubscribeStartAtOldestRecord EvtSubscribeStartAfterBookmark
`EvtSubscribeTolerateQueryErrors` Valeur : 0x1000 Terminez l’abonnement même si la partie de la requête génère une erreur (n’est pas bien formée). Le service valide la syntaxe de la requête XPath pour déterminer si elle est bien formée. Si la validation échoue, le service analyse le XPath en expressions individuelles. Il génère une nouvelle XPath commençant par l’expression la plus à gauche. Le service valide l’expression et, si elle est valide, il ajoute l’expression suivante au XPath. Le service répète ce processus jusqu’à ce qu’il trouve l’expression qui échoue. Il utilise ensuite les expressions valides qu’il a trouvées en commençant par l’expression la plus à gauche comme requête XPath (ce qui signifie que vous risquez de ne pas obtenir les événements attendus). Si aucune partie de XPath n’est valide, l’appel EvtSubscribe échoue.
`EvtSubscribeStrict` Valeur : 0x10000 Force l’appel EvtSubscribe à échouer si vous spécifiez EvtSubscribeStartAfterBookmark et que l’événement signet est introuvable (la valeur de retour est ERROR_NOT_FOUND). Définissez également cet indicateur si vous souhaitez recevoir une notification dans votre rappel lorsque des enregistrements d’événements sont manquants.

Remarques

Les indicateurs EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord et EvtSubscribeStartAfterBookmark s’excluent mutuellement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	winevt.h

Voir aussi

EvtSubscribe

Partager via