Tipo complejo ChannelType

Define un canal al que los proveedores pueden 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 secundarios

Elemento	Tipo	Descripción
Registro	ChannelLoggingType	Define las propiedades del archivo de registro que respalda el canal, como su capacidad y si el archivo de registro es secuencial o circular.
Editorial	ChannelPublishingType	Define las propiedades de registro de la sesión que usa el canal. Solo los canales y canales de depuración y análisis que usan aislamiento personalizado pueden especificar propiedades de registro para su sesión.

Atributos

Nombre	Tipo	Descripción
acceso	string	Un descriptor de acceso del Lenguaje de definición de descriptores de seguridad (SDDL) que controla el acceso al archivo de registro que respalda el canal. Si el atributo de aislamiento se establece en Application o System, el descriptor de acceso controla el acceso de lectura al archivo (se omiten los permisos de escritura). Si el atributo de aislamiento se establece en Personalizado, el descriptor de acceso controla el acceso de escritura al canal y el acceso de lectura al archivo.
chid	token	Identificador que identifica de forma única el canal en la lista de canales que el proveedor define o importa. Use este valor al hacer referencia al canal en un evento. Si no especifica un identificador de canal, use el nombre del canal para hacer referencia a este canal en una definición de evento.
enabled	boolean	Determina si el canal está habilitado. Establézcalo en true para permitir el registro en el canal; de lo contrario, false. El valor predeterminado es false (el registro está deshabilitado). Dado que los tipos de canal de depuración y análisis son canales de gran volumen, debe habilitar el canal solo al investigar un problema con un componente que escribe en ese canal; de lo contrario, el canal debe permanecer deshabilitado. Cada vez que habilita un canal de depuración y análisis, el servicio borra los eventos del canal.
aislamiento de	string	El valor de aislamiento define los permisos de acceso predeterminados para el canal. Puede especificar uno de los siguientes valores: Aplicación Sistema Personalizada El aislamiento predeterminado es Application. Los permisos predeterminados para La aplicación se muestran (se muestran mediante 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) Los permisos predeterminados para System se muestran (se muestran mediante 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) Los permisos predeterminados para el aislamiento personalizado son los mismos que la aplicación. Los canales que especifican aislamiento de la aplicación usan la misma sesión ETW. Lo mismo sucede con el aislamiento del sistema . Sin embargo, si especifica Aislamiento personalizado , el servicio crea una sesión ETW independiente para el canal. El uso del aislamiento personalizado le permite controlar los permisos de acceso para el canal y el archivo de respaldo. Dado que solo hay 64 sesiones ETW disponibles, debe limitar el uso del aislamiento personalizado .
message	string	Nombre para mostrar localizado para el canal. La cadena de mensaje hace referencia a una cadena localizada en la sección stringTable del manifiesto.
name	anyURI	Nombre del canal. El nombre debe ser único dentro de la lista de canales que usa el proveedor. La convención para asignar nombres a canales es anexar el tipo de canal al nombre del proveedor. Por ejemplo. Si el nombre del proveedor es Company-Product-Component y está definiendo un canal operativo, el nombre sería Company-Product-Component/Operational. Los nombres de canal deben tener menos de 255 caracteres y no pueden contener los siguientes caracteres: '>', '<', '&', ''', '|', '\', ':', '', '?', '*' o caracteres con códigos inferiores a 31.
símbolo	CSymbolType	Símbolo que se va a usar para hacer referencia al canal de la aplicación. El compilador de mensajes (MC.exe) usa el símbolo para crear una constante para el canal en el archivo de encabezado que genera el compilador. Si no especifica un símbolo, el compilador genera el nombre automáticamente.
tipo	string	Identifica el tipo del canal. Puede especificar uno de los siguientes tipos: Administrador Operativos Analíticos Depurar Administración canales de tipo admiten eventos dirigidos a usuarios finales, administradores y personal de soporte técnico. Los eventos escritos en los canales Administración deben tener una solución bien definida en la que el administrador pueda actuar. Un ejemplo de un evento de administrador es un evento que se produce cuando una aplicación no puede conectarse a una impresora. Estos eventos están bien documentados o tienen un mensaje asociado a ellos que proporciona al lector instrucciones directas de lo que se debe hacer para rectificar el problema. Los canales de tipo operativo admiten eventos que se usan para analizar y diagnosticar un problema o repetición. Se pueden utilizar para activar herramientas o tareas según el problema o la incidencia. Un ejemplo de un evento operativo es un evento que se produce cuando se agrega o se quita una impresora de un sistema. Los canales de tipo analítico admiten eventos publicados en gran volumen. Describen el funcionamiento del programa e indican los problemas que el usuario no puede administrar. Los canales de tipo de depuración admiten eventos que los desarrolladores usan únicamente para diagnosticar un problema para la depuración. Los canales analíticos y de depuración están deshabilitados de forma predeterminada y solo deben habilitarse para determinar la causa de un problema. Por ejemplo, habilitaría el canal, ejecutaría el escenario que está causando el problema, deshabilite el canal y, a continuación, consulte los eventos. Tenga en cuenta que al habilitar el canal se borra el canal de los eventos existentes. Si el canal analítico y de depuración usa un archivo de respaldo circular, debe deshabilitar el canal para consultar sus eventos. Todos los canales Administración usan la misma sesión ETW; lo mismo sucede con los canales operativos. Sin embargo, cada canal analítico y de depuración usa una sesión ETW independiente, que es otra razón para habilitar estos tipos de canal cuando sea necesario (hay un número limitado de sesiones ETW disponibles).
value	UInt8Type	Identificador numérico que identifica de forma única el canal dentro de la lista de canales que define el proveedor. El compilador de mensajes asigna el valor si no se especifica.

Observaciones

Si el nombre del canal sigue la convención de nomenclatura del canal, el Visor de eventos de Windows mostrará el canal con la cadena que sigue a la barra diagonal inversa. Por ejemplo, si el nombre del canal es Company-Product-Component/Operational, el Visor de eventos enumerará el canal como Operativo en el proveedor Company-Product-Component. De lo contrario, se muestra el nombre completo del canal en el proveedor. Si se proporciona, se usa el nombre para mostrar localizado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]

`