Tipo complexo ChannelType

Define um canal para o qual os provedores podem registrar eventos.

<xs:complexType name="ChannelType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="logging"
            type="ChannelLoggingType"
            minOccurs="0"
         />
        <xs:element name="publishing"
            type="ChannelPublishingType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="chid"
        type="token"
        use="optional"
     />
    <xs:attribute name="type"
        type="string"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="optional"
     />
    <xs:attribute name="access"
        type="string"
        use="optional"
     />
    <xs:attribute name="isolation"
        type="string"
        use="optional"
     />
    <xs:attribute name="enabled"
        type="boolean"
        default="false"
        use="optional"
     />
    <xs:attribute name="value"
        type="UInt8Type"
        use="optional"
     />
    <xs:attribute name="message"
        type="string"
        use="optional"
     />
</xs:complexType>

Elementos filho

Elemento	Type	Descrição
Log	ChannelLoggingType	Define as propriedades do arquivo de log que faz backup do canal, como sua capacidade e se o arquivo de log é sequencial ou circular.
Publicação	ChannelPublishingType	Define as propriedades de registro em log para a sessão que o canal usa. Somente canais e canais de Depuração e Análise que usam isolamento personalizado podem especificar propriedades de log para sua sessão.

Atributos

Nome	Type	Descrição
access	string	Um descritor de acesso SDDL ( Security Descriptor Definition Language ) que controla o acesso ao arquivo de log que faz backup do canal. Se o atributo de isolamento estiver definido como Aplicativo ou Sistema, o descritor de acesso controlará o acesso de leitura ao arquivo (as permissões de gravação serão ignoradas). Se o atributo de isolamento estiver definido como Personalizado, o descritor de acesso controlará o acesso de gravação ao canal e o acesso de leitura ao arquivo.
chid	token	Um identificador que identifica exclusivamente o canal na lista de canais que o provedor define ou importa. Use esse valor ao referenciar o canal em um evento. Se você não especificar um identificador de canal, use o nome do canal para referenciar esse canal em uma definição de evento.
Habilitado	booleano	Determina se o canal está habilitado. Defina como true para permitir o registro em log no canal; caso contrário, false. O padrão é false (o registro em log está desabilitado). Como os tipos de canal de Depuração e Análise são canais de alto volume, você deve habilitar o canal somente ao investigar um problema com um componente que grava nesse canal; caso contrário, o canal deverá permanecer desabilitado. Sempre que você habilita um canal de Depuração e Análise, o serviço limpa os eventos do canal.
isolamento	string	O valor de isolamento define as permissões de acesso padrão para o canal. É possível especificar um dos seguintes valores: Aplicativo System Personalizado O isolamento padrão é Application. As permissões padrão para o Aplicativo são (mostradas usando SDDL): Texto L"O:BAG:SYD:" L"(A;;0xf0007;;;SY)" // local system (read, write, clear) L"(A;;0x7;;;BA)" // built-in admins (read, write, clear) L"(A;;0x7;;;SO)" // server operators (read, write, clear) L"(A;;0x3;;;IU)" // INTERACTIVE LOGON (read, write) L"(A;;0x3;;;SU)" // SERVICES LOGON (read, write) L"(A;;0x3;;;S-1-5-3)" // BATCH LOGON (read, write) L"(A;;0x3;;;S-1-5-33)" // write restricted service (read, write) L"(A;;0x1;;;S-1-5-32-573)"; // event log readers (read) As permissões padrão para System são (mostradas usando SDDL): Texto L"O:BAG:SYD:" L"(A;;0xf0007;;;SY)" // local system (read, write, clear) L"(A;;0x7;;;BA)" // built-in admins (read, write, clear) L"(A;;0x3;;;BO)" // backup operators (read, write) L"(A;;0x5;;;SO)" // server operators (read, clear) L"(A;;0x1;;;IU)" // INTERACTIVE LOGON (read) L"(A;;0x3;;;SU)" // SERVICES LOGON (read, write) L"(A;;0x1;;;S-1-5-3)" // BATCH LOGON (read) L"(A;;0x2;;;S-1-5-33)" // write restricted service (write) L"(A;;0x1;;;S-1-5-32-573)"; // event log readers (read) As permissões padrão para Isolamento personalizado são as mesmas do Aplicativo. Os canais que especificam o isolamento do aplicativo usam a mesma sessão ETW. O mesmo vale para o isolamento do sistema . No entanto, se você especificar Isolamento personalizado , o serviço criará uma sessão ETW separada para o canal. O uso do isolamento personalizado permite controlar as permissões de acesso para o canal e o arquivo de backup. Como há apenas 64 sessões ETW disponíveis, você deve limitar o uso de Isolamento personalizado .
message	string	O nome de exibição localizado para o canal. A cadeia de caracteres de mensagem faz referência a uma cadeia de caracteres localizada na seção stringTable do manifesto.
name	anyURI	O nome do canal. O nome deve ser exclusivo na lista de canais que o provedor usa. A convenção para nomenclatura de canais é acrescentar o tipo de canal ao nome do provedor. Por exemplo. se o nome do provedor for Company-Product-Component e você estiver definindo um canal operacional, o nome será Company-Product-Component/Operational. Os nomes de canal devem ter menos de 255 caracteres e não podem conter os seguintes caracteres: '>', '<', '&', '"', '|', '\', ':', '', '?', '*' ou caracteres com códigos menores que 31.
símbolo	CSymbolType	O símbolo a ser usado para fazer referência ao canal em seu aplicativo. O Compilador de Mensagens (MC.exe) usa o símbolo para criar uma constante para o canal no arquivo de cabeçalho gerado pelo compilador. Se você não especificar um símbolo, o compilador gerará o nome para você.
tipo	string	Identifica o tipo do canal. Você pode especificar um dos seguintes tipos: Administrador Operacional Analítico Depurar Administração canais de tipo dão suporte a eventos direcionados a usuários finais, administradores e pessoal de suporte. Os eventos gravados nos canais de Administração devem ter uma solução bem definida na qual o administrador pode agir. Um exemplo de um evento de administrador é um evento que ocorre quando um aplicativo falha ao se conectar a uma impressora. Esses eventos são bem documentados ou têm uma mensagem associada a eles que fornece ao leitor instruções diretas sobre o que deve ser feito para corrigir o problema. Os canais de tipo operacional dão suporte a eventos que são usados para analisar e diagnosticar um problema ou ocorrência. Eles podem ser usados para disparar ferramentas ou tarefas com base no problema ou na ocorrência. Um exemplo de evento operacional é um evento que ocorre quando uma impressora é adicionada ou removida de um sistema. Os canais de tipo analítico dão suporte a eventos publicados em alto volume. Eles descrevem a operação do programa e indicam os problemas que não podem ser tratados por intervenção do usuário. Os canais de tipo de depuração dão suporte a eventos que são usados exclusivamente por desenvolvedores para diagnosticar um problema de depuração. Os canais analíticos e de depuração são desabilitados por padrão e só devem ser habilitados para determinar a causa de um problema. Por exemplo, você habilitaria o canal, executaria o cenário que está causando o problema, desabilitaria o canal e, em seguida, consultaria os eventos. Observe que habilitar o canal limpa o canal de eventos existentes. Se o canal analítico e de depuração usar um arquivo de suporte circular, você deverá desabilitar o canal para consultar seus eventos. Todos os canais Administração usam a mesma sessão ETW; o mesmo vale para canais operacionais. No entanto, cada canal analítico e de depuração usa uma sessão ETW separada, o que é outro motivo para habilitar esses tipos de canal somente quando necessário (há um número limitado de sessões ETW disponíveis).
value	UInt8Type	Um identificador numérico que identifica exclusivamente o canal dentro da lista de canais que o provedor define. O compilador de mensagem atribuirá o valor se não for especificado.

Comentários

Se o nome do canal seguir a convenção de nomenclatura do canal, o Visualizador de Eventos do Windows listará o canal usando a cadeia de caracteres que segue a barra invertida. Por exemplo, se o nome do canal for Company-Product-Component/Operational, o Visualizador de Eventos listará o canal como Operacional no provedor Company-Product-Component. Caso contrário, todo o nome do canal será mostrado no provedor. O nome de exibição localizado será usado se for fornecido.

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]

`