Tipo complexo EventDefinitionType

  • Artigo

Define um evento que seu provedor pode gravar.

<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>

Atributos

Nome Type Descrição
channel token Um identificador que identifica o canal no qual o evento é gravado. Especifique um identificador de canal de um dos canais que você definiu ou importou. Se o canal não especificar um identificador de canal, use o nome do canal. Para obter detalhes sobre como definir ou importar um canal, consulte o tipo complexo ChannelListType .
Se você não especificar um canal, o evento não será gravado em um canal. Normalmente, o único motivo para não especificar um canal é se você estiver escrevendo eventos apenas em uma sessão ETW. Para obter detalhes, consulte criando uma sessão ETW em Controlando sessões de rastreamento de eventos.
palavras-chave QNameList Uma lista separada por espaço de nomes de palavra-chave que identificam a categoria de eventos aos quais esse evento pertence. Especifique um nome de palavra-chave na lista de palavras-chave que você definir. Para obter detalhes sobre como definir palavras-chave, consulte o tipo complexo KeywordType .
Se você não especificar palavras-chave, o descritor de evento conterá um zero para palavras-chave.
nível QName O nível de detalhamento a ser usado ao gravar o evento. Especifique o nome de um nível que você definiu no manifesto ou um dos níveis definidos no arquivo \Include\Winmeta.xml incluído no SDK do Windows. Para obter detalhes sobre como definir um nível, consulte o tipo complexo LevelType .
Se você não especificar um nível, o descritor de evento conterá um zero para o nível.
Você deve especificar um nível se o tipo de canal no qual o evento é gravado for Administração; o nível deverá ser um dos seguintes níveis definidos em Winmeata.xml:
  • win:Critical
  • win:Error
  • win:Warning
  • win:Informational
message strTableRef A mensagem localizada para o evento. A cadeia de caracteres de mensagem faz referência a uma cadeia de caracteres localizada na seção stringTable do manifesto.
Você deve especificar uma mensagem se o tipo de canal no qual o evento é gravado for Administração.
notLogged booleano Determina se o provedor registra esse evento em log. Especifique true se o provedor registrar esse evento; caso contrário, false. Use esse atributo para indicar que o provedor não está mais registrando esse evento em vez de remover o evento do manifesto. Manter o evento no manifesto permitirá que os consumidores decodificem arquivos etl mais antigos que incluem o evento.
Windows Server 2008 e Windows Vista: Não há suporte para esse atributo em versões do compilador de mensagens que foram enviadas antes da versão do Windows 7 do SDK do Windows.
Opcode QName O nome de um opcode que identifica uma operação dentro da tarefa. Especifique o nome de um opcode que você definiu no manifesto ou um dos opcodes definidos em Winmeta.xml. Para obter detalhes sobre como definir um opcode, consulte o tipo complexo OpcodeType .
Se a tarefa referenciada contiver opcodes específicos da tarefa (local), você poderá especificar um de seus opcodes específicos da tarefa ou um opcode definido no nível do provedor (um opcode global). Se você especificar um opcode global, o valor do opcode global não poderá ser o mesmo que um dos opcodes locais para a tarefa.
Se você fizer referência a um opcode local, o atributo de tarefa deverá referenciar a tarefa à qual o opcode local pertence.
Se você não especificar um opcode, o descritor de evento conterá um zero para opcode.
símbolo CSymbolType O símbolo a ser usado para referenciar o descritor de evento para esse evento em seu aplicativo. O Compilador de Mensagens (MC.exe) usa o símbolo para criar uma constante para o descritor de evento no arquivo de cabeçalho gerado pelo compilador. Se você não especificar um símbolo, o compilador gerará um para você. Você usa o descritor quando chama a função EventWrite para gravar o evento.
task QName O nome de uma tarefa que identifica o componente ou subcomponente que gera esse evento. Especifique o nome de uma tarefa que você definiu no manifesto. Para obter detalhes sobre como definir uma tarefa, consulte o tipo complexo TaskType .
Se você não especificar uma tarefa, o descritor de evento conterá um zero para a tarefa.
template token O identificador de modelo do modelo que define os itens de dados que esse evento inclui. Especifique o identificador de um modelo que você definiu no manifesto. Para obter detalhes sobre como definir um modelo, consulte o tipo complexo TemplateItemType .
value UInt32Type O identificador de evento. O identificador deve ser exclusivo na lista de eventos que você definir.
version unsignedByte Um número de versão de um byte da definição do evento.

Comentários

Se você usar EvtFormatMessage para formatar a cadeia de caracteres de mensagem para o evento (ou usar o Visualizador de Eventos para exibir a cadeia de caracteres de mensagem), a cadeia de caracteres de mensagem poderá conter cadeias de caracteres de inserção e qualquer uma das cadeias de caracteres de formato compatíveis com a função FormatMessage win32. As cadeias de caracteres de inserção são limitadas a %n ou %n!s! (por exemplo, %1) em que n é a referência baseada em um dos itens de dados definidos no modelo do evento. A cadeia de caracteres de mensagem também pode conter cadeias de caracteres de inserção de parâmetros no formato %%n (por exemplo, %%4). O número máximo de cadeias de caracteres de inserção que a mensagem pode conter é 100.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]