Type complexe ChannelType
Définit un canal auquel les fournisseurs peuvent enregistrer des événements.
<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>
Éléments enfants
| Élément | Type | Description |
|---|---|---|
| fermeture | ChannelLoggingType | Définit les propriétés du fichier journal qui stocke le canal, par exemple sa capacité et si le fichier journal est séquentiel ou circulaire. |
| publiée | ChannelPublishingType | Définit les propriétés de journalisation pour la session utilisée par le canal. Seuls les canaux de débogage et d’analyse et les canaux qui utilisent l’isolation personnalisée peuvent spécifier des propriétés de journalisation pour leur session. |
Attributs
| Nom | Type | Description | ||||
|---|---|---|---|---|---|---|
| access | string | Descripteur d’accès SDDL ( Security Descriptor Definition Language ) qui contrôle l’accès au fichier journal qui stocke le canal. Si l’attribut isolation est défini sur application ou système, le descripteur d' accès contrôle l’accès en lecture au fichier (les autorisations d’écriture sont ignorées). Si l’attribut isolation est défini sur personnalisé, le descripteur d’accès contrôle l’accès en écriture au canal et l’accès en lecture au fichier. |
||||
| enfants | token | Identificateur qui identifie de façon unique le canal dans la liste des canaux que le fournisseur définit ou importe. Utilisez cette valeur lorsque vous référencez le canal dans un événement. Si vous ne spécifiez pas d’identificateur de canal, utilisez le nom du canal pour référencer ce canal dans une définition d’événement. |
||||
| enabled | boolean | Détermine si le canal est activé. Affectez la valeur true pour autoriser la journalisation sur le canal ; Sinon, false. La valeur par défaut est false (la journalisation est désactivée). Étant donné que les types de canal de débogage et d’analyse sont des canaux de volume élevés, vous devez activer le canal uniquement lors de l’examen d’un problème lié à un composant qui écrit sur ce canal. dans le cas contraire, le canal doit rester désactivé. Chaque fois que vous activez un canal de débogage et d’analyse, le service efface les événements du canal. |
||||
| isolation | string | La valeur d’isolation définit les autorisations d’accès par défaut pour le canal. Vous pouvez spécifier l'une des valeurs suivantes :
Les autorisations par défaut pour System sont (illustrées à l’aide de SDDL) :
Les autorisations par défaut pour l’isolation personnalisée sont les mêmes que celles de l’application. Les canaux qui spécifient l’isolation des applications utilisent la même session ETW. Il en va de même pour l’isolation du système . Toutefois, si vous spécifiez l’isolation personnalisée , le service crée une session ETW distincte pour le canal. L’utilisation de l’isolation personnalisée vous permet de contrôler les autorisations d’accès pour le canal et le fichier de sauvegarde. Étant donné que seules les sessions ETW 64 sont disponibles, vous devez limiter votre utilisation de l’isolation personnalisée . |
||||
| message | string | Nom complet localisé pour le canal. La chaîne de message fait référence à une chaîne localisée dans la section STRINGTABLE du manifeste. |
||||
| name | anyURI | Nom du canal. Le nom doit être unique dans la liste des canaux utilisés par le fournisseur. La Convention d’affectation de noms de canaux consiste à ajouter le type de canal au nom du fournisseur. Par exemple, Si le nom du fournisseur est société-produit et que vous définissez un canal opérationnel, le nom serait société-produit-composant/opérationnel. Les noms de canaux doivent comporter moins de 255 caractères et ne peuvent pas contenir les caractères suivants : ' > ', '<', '&', '"', '|', '\', ':', '`', '?', '*', or characters with codes less than 31. |
||||
| symbole | CSymbolType | Symbole à utiliser pour référencer le canal dans votre application. Le compilateur de message (MC.exe) utilise le symbole pour créer une constante pour le canal dans le fichier d’en-tête généré par le compilateur. Si vous ne spécifiez pas de symbole, le compilateur génère le nom pour vous. |
||||
| type | string | Identifie le type du canal. Vous pouvez spécifier l’un des types suivants :
Les canaux de type administrateur prennent en charge les événements qui ciblent les utilisateurs finaux, les administrateurs et le personnel de support. Les événements écrits dans les canaux d’administration doivent avoir une solution bien définie sur laquelle l’administrateur peut agir. Un exemple d’événement d’administration est un événement qui se produit lorsqu’une application ne parvient pas à se connecter à une imprimante. Ces événements sont bien documentés ou sont associés à un message qui donne aux lecteurs des instructions directes sur ce qui doit être fait pour résoudre le problème. Les canaux de type opérationnel prennent en charge les événements qui sont utilisés pour analyser et diagnostiquer un problème ou une occurrence. Ils peuvent être utilisés pour déclencher des outils ou des tâches selon le problème ou l'occurrence. Un exemple d'événement opérationnel est un événement qui se produit lorsqu'une imprimante est ajoutée ou supprimée d'un système. Les canaux de type analytique prennent en charge les événements publiés dans un volume élevé. Ils décrivent une opération de programme et indiquent des problèmes qui ne peuvent pas être pris en charge par une intervention de l'utilisateur. Les canaux de type de débogage prennent en charge les événements qui sont utilisés uniquement par les développeurs pour diagnostiquer un problème de débogage. Les canaux d’analyse et de débogage sont désactivés par défaut et ne doivent être activés que pour déterminer la cause d’un problème. Par exemple, vous activez le canal, exécutez le scénario qui est à l’origine du problème, désactivez le canal, puis interrogez les événements. Notez que l’activation du canal efface le canal des événements existants. Si le canal d’analyse et de débogage utilise un fichier de sauvegarde circulaire, vous devez désactiver le canal pour interroger ses événements. Tous les canaux d’administration utilisent la même session ETW. Il en va de même pour les canaux opérationnels. Toutefois, chaque canal d’analyse et de débogage utilise une session ETW distincte, qui est une autre raison d’activer uniquement ces types de canaux quand cela est nécessaire (il existe un nombre limité de sessions ETW disponibles). |
||||
| value | UInt8Type | Identificateur numérique qui identifie de façon unique le canal dans la liste des canaux que le fournisseur définit. Le compilateur de message affecte la valeur si elle n’est pas spécifiée. |
Remarques
si le nom du canal suit la convention d’affectation de noms de canaux, le Windows observateur d’événements répertorie le canal à l’aide de la chaîne qui suit la barre oblique inverse. Par exemple, si le nom de canal est société-produit-composant/opérationnel, le observateur d’événements répertorie le canal comme opérationnel sous le fournisseur de composants de produit de la société. Dans le cas contraire, le nom de canal entier est affiché sous le fournisseur. Le nom complet localisé est utilisé, s’il est fourni.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 [ applications de bureau uniquement] |
`