Condividi tramite

Tipo complesso EventDefinitionType

  • Articolo

Definisce un evento che il provider può scrivere.

<xs:complexType name="EventDefinitionType">
    <xs:simpleContent>
        <xs:extension
            base="string"
        >
            <xs:attribute name="value"
                type="UInt32Type"
                use="required"
             />
            <xs:attribute name="level"
                type="QName"
                use="optional"
             />
            <xs:attribute name="template"
                type="token"
                use="optional"
             />
            <xs:attribute name="channel"
                type="token"
                use="optional"
             />
            <xs:attribute name="keywords"
                type="QNameList"
                use="optional"
             />
            <xs:attribute name="task"
                type="QName"
                use="optional"
             />
            <xs:attribute name="opcode"
                type="QName"
                use="optional"
             />
            <xs:attribute name="symbol"
                type="CSymbolType"
                use="optional"
             />
            <xs:attribute name="version"
                type="unsignedByte"
                use="optional"
             />
            <xs:attribute name="message"
                type="strTableRef"
                use="optional"
             />
            <xs:attribute name="notLogged"
                type="boolean"
                use="optional"
                default="false"
             />
        </xs:extension>
    </xs:simpleContent>
</xs:complexType>

Attributi

Nome Tipo Descrizione
channel token Identificatore che identifica il canale in cui viene scritto l'evento. Specificare un identificatore di canale di uno dei canali definiti o importati. Se il canale non specifica un identificatore di canale, usare il nome del canale. Per informazioni dettagliate sulla definizione o l'importazione di un canale, vedere il tipo complesso ChannelListType .
Se non si specifica un canale, l'evento non viene scritto in un canale. In genere, l'unico motivo per cui non specificare un canale è se si scrivono eventi solo in una sessione ETW. Per informazioni dettagliate, vedere Creazione di una sessione ETW, vedere Controllo delle sessioni di traccia eventi.
keywords QNameList Elenco delimitato dallo spazio dei nomi delle parole chiave che identificano la categoria di eventi a cui appartiene questo evento. Specificare un nome di parola chiave dall'elenco di parole chiave definite. Per informazioni dettagliate sulla definizione delle parole chiave, vedere il tipo complesso KeywordType .
Se non si specificano parole chiave, il descrittore dell'evento conterrà zero per le parole chiave.
livello QName Livello di verbosità da usare durante la scrittura dell'evento. Specificare il nome di un livello definito nel manifesto o uno dei livelli definiti nel file \Include\Winmeta.xml incluso in Windows SDK. Per informazioni dettagliate sulla definizione di un livello, vedere il tipo complesso LevelType .
Se non si specifica un livello, il descrittore dell'evento conterrà zero per il livello.
È necessario specificare un livello se il tipo di canale a cui viene scritto l'evento è Amministrazione; il livello deve essere uno dei livelli seguenti definiti in Winmeata.xml:
  • win:Critical
  • win:Error
  • win:Warning
  • win:Informational
message strTableRef Messaggio localizzato per l'evento. La stringa del messaggio fa riferimento a una stringa localizzata nella sezione stringTable del manifesto.
È necessario specificare un messaggio se il tipo di canale a cui viene scritto l'evento è Amministrazione.
not Log boolean Determina se il provider registra questo evento. Specificare true se il provider registra questo evento; in caso contrario, false. Usare questo attributo per indicare che il provider non registra più questo evento anziché rimuovere l'evento dal manifesto. La conservazione dell'evento nel manifesto consentirà ai consumer di decodificare i file etl meno recenti che includono l'evento.
Windows Server 2008 e Windows Vista: Questo attributo non è supportato nelle versioni del compilatore di messaggi che sono state inviate prima della versione di Windows 7 di Windows SDK.
Opcode QName Nome di un codice opcode che identifica un'operazione all'interno dell'attività. Specificare il nome di un opcode definito nel manifesto o in uno dei codici opcode definiti in Winmeta.xml. Per informazioni dettagliate sulla definizione di un codice opcode, vedere il tipo complesso OpcodeType .
Se l'attività a cui si fa riferimento contiene opcode opcode specifici dell'attività (locale), è possibile specificare uno dei relativi opcode specifici dell'attività o un codice opcode definito a livello di provider (un codice opcode globale). Se si specifica un codice opcode globale, il valore del codice opcode globale non può essere uguale a uno dei codici opcode locali per l'attività.
Se si fa riferimento a un codice opcode locale, l'attributo dell'attività deve fare riferimento all'attività a cui appartiene il codice opcode locale.
Se non si specifica un codice opcode, il descrittore dell'evento conterrà uno zero per opcode.
simbolo CSymbolType Simbolo da usare per fare riferimento al descrittore dell'evento per questo evento nell'applicazione. Il compilatore di messaggi (MC.exe) usa il simbolo per creare una costante per il descrittore di eventi nel file di intestazione generato dal compilatore. Se non si specifica un simbolo, il compilatore genera uno per l'utente. Si usa il descrittore quando si chiama la funzione EventWrite per scrivere l'evento.
attività QName Nome di un'attività che identifica il componente o il sottocomponente che genera questo evento. Specificare il nome di un'attività definita nel manifesto. Per informazioni dettagliate sulla definizione di un'attività, vedere il tipo complesso TaskType .
Se non si specifica un'attività, il descrittore di eventi conterrà zero per l'attività.
template token Identificatore del modello che definisce gli elementi di dati inclusi in questo evento. Specificare l'identificatore di un modello definito nel manifesto. Per informazioni dettagliate sulla definizione di un modello, vedere il tipo complesso TemplateItemType .
Valore UInt32Type Identificatore dell'evento. L'identificatore deve essere univoco all'interno dell'elenco di eventi definiti.
version unsignedByte Numero di versione un byte della definizione dell'evento.

Commenti

Se si usa EvtFormatMessage per formattare la stringa di messaggio per l'evento o usare il Visualizzatore eventi per visualizzare la stringa di messaggio, la stringa di messaggio può contenere stringhe di inserimento e una delle stringhe di formato supportate dalla funzione Win32 FormatMessage. Le stringhe di inserimento sono limitate a %n o %n!s! Ad esempio, %1) dove n è il riferimento one-based agli elementi di dati definiti nel modello dell'evento. La stringa del messaggio può contenere anche stringhe di inserimento dei parametri nel formato %%n (ad esempio %%4). Il numero massimo di stringhe di inserimento che il messaggio può contenere è 100.

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2008 [solo app desktop]