struttura EVENT_DESCRIPTOR (relogger.h)
La struttura EVENT_DESCRIPTOR contiene metadati che definiscono l'evento.
Sintassi
typedef struct _EVENT_DESCRIPTOR {
USHORT Id;
UCHAR Version;
UCHAR Channel;
UCHAR Level;
UCHAR Opcode;
USHORT Task;
ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;
Members
Id
Identificatore dell'evento.
Version
Versione dell'evento. La versione indica una revisione della definizione dell'evento. È possibile usare questo membro e il membro ID per identificare in modo univoco l'evento nell'ambito di un provider.
Channel
Destinatari dell'evento , ad esempio amministratore o sviluppatore.
Level
Gravità o livello di dettaglio inclusi nell'evento (ad esempio, informativo o irreversibile).
Opcode
Passaggio in una sequenza di operazioni eseguite all'interno dell'attività.
Task
Un'unità di lavoro più grande all'interno di un'applicazione o di un componente (è più ampia di Opcode).
Keyword
Maschera di bit che specifica un gruppo logico di eventi correlati. Ogni bit corrisponde a un gruppo. Un evento può appartenere a uno o più gruppi. La parola chiave può contenere una o più parole chiave definite dal provider, parole chiave standard o entrambe.
Commenti
Questa struttura rappresenta un evento definito nel manifesto. Non si dichiara e si popola questa struttura, ma si usa il compilatore di messaggi (MC.exe) per generare un file di intestazione che dichiara e popola questa struttura per ogni evento nel manifesto. Per informazioni dettagliate sulla scrittura del manifesto e sulla generazione del file di intestazione, vedere Scrittura di un manifesto di strumentazione e compilazione di un manifesto di strumentazione.
Per informazioni dettagliate sui membri di questa struttura, vedere gli attributi del tipo complesso EventDefinitionType .
Questa struttura viene specificata quando si chiama EventWrite o EventWriteTransfer per scrivere l'evento. È anche possibile usarlo quando si chiama EventEnabled per determinare se è necessario scrivere l'evento.
Questa struttura è inclusa anche nella struttura EVENT_HEADER restituita con il record dell'evento quando si utilizzano gli eventi usando il callback EventRecordCallback . Per gli eventi definiti da MOF, il membro Opcode contiene il valore del tipo di evento. I membri Version e Level contengono le informazioni previste.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Intestazione | relogger.h (include Evntprov.h) |