Type complexe ProviderType

Article
06/13/2023

Définit un fournisseur et les métadonnées qu’il utilise pour définir ses événements.

<xs:complexType name="ProviderType">
    <xs:choice
        minOccurs="0"
        maxOccurs="unbounded"
    >
        <xs:element name="channels"
            type="ChannelListType"
         />
        <xs:element name="levels"
            type="LevelListType"
         />
        <xs:element name="tasks"
            type="TaskListType"
         />
        <xs:element name="opcodes"
            type="OpcodeListType"
         />
        <xs:element name="keywords"
            type="KeywordListType"
         />
        <xs:element name="maps"
            type="MapType"
         />
        <xs:element name="namedQueries"
            type="NamedQueryType"
         />
        <xs:element name="templates"
            type="TemplateListType"
         />
        <xs:element name="events"
            type="DefinitionType"
         />
        <xs:element name="filters"
            type="FilterListType"
         />
        <xs:any
            processContents="lax"
            namespace="##other"
         />
    </xs:choice>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="guid"
        type="GUIDType"
        use="required"
     />
    <xs:attribute name="resourceFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="messageFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="parameterFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="helpLink"
        type="anyURI"
        use="optional"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="required"
     />
    <xs:attribute name="message"
        type="strTableRef"
        use="optional"
     />
    <xs:attribute name="source"
        use="optional"
        default="Xml"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="Xml"
                 />
                <xs:enumeration
                    value="Wbem"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="warnOnApplicationCompatibilityError"
        type="xs:boolean"
        use="optional"
        default="false"
     />
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

Éléments enfants

Élément	Type	Description
channels	ChannelListType	Définit une liste de canaux sur lesquels les fournisseurs peuvent journaliser des événements.
Événements	DefinitionType	Définit une liste de définitions d’événements des événements que le fournisseur peut enregistrer.
Filtres	FilterListType	Définit une liste de filtres pris en charge par votre fournisseur. Vous pouvez utiliser les filtres, comme vous le feriez pour le niveau et les mots clés, pour déterminer si vous souhaitez écrire un événement. Windows Server 2008 et Windows Vista : Non pris en charge jusqu’à Windows 7.
Mots-clés	KeywordListType	Définit une liste de mots clés qui catégorisent les événements.
Niveaux	LevelListType	Définit une liste de niveaux qui spécifient la gravité d’un événement.
Cartes	MapType	Définit une liste de paires nom/valeur que vous pouvez référencer dans la section modèle du manifeste.
namedQueries	NamedQueryType	Non utilisé. Définit une liste de requêtes nommées qui interrogent la chaîne de message d’événement pour une valeur et effectuent une action spécifiée si elle est trouvée.
Opcodes	OpcodeListType	Définit une liste d’opcodes que vous pouvez utiliser pour regrouper des événements au sein d’une tâche.
Tâches	TaskListType	Définit une liste de tâches qu’un fournisseur peut utiliser pour regrouper des événements. En règle générale, vous utilisez des tâches pour regrouper des événements pour une fonctionnalité ou un composant du fournisseur.
Modèles	TemplateListType	Définit une liste de modèles qui spécifient les données à inclure dans les événements.

Attributs

Nom	Type	Description
guid	GUIDType	GUID qui identifie de manière unique le fournisseur.
Helplink	anyURI	Lien d’URL ou d’aide MS vers du contenu qui fournit des informations sur les événements que le fournisseur déclenche.
message	strTableRef	Nom complet localisé pour le fournisseur. La chaîne de message fait référence à une chaîne localisée dans la section stringTable du manifeste.
messageFileName	filePath	Chemin d’accès complet au fichier qui contient les ressources de message localisées du fournisseur. Le fichier peut être un fichier exécutable ou un fichier DLL.
name	anyURI	Nom du fournisseur. Le nom doit être au formatComposantproduit- de l’entreprise-. Le nom ne peut pas contenir plus de 255 caractères et ne peut pas contenir les caractères « »,> «< », «& », « \| », « \ », « : », « », « », « ? », « * » ou des caractères dont les codes sont inférieurs à 31. En outre, le nom doit respecter les contraintes générales sur les noms de clés de fichier et de Registre. Ces contraintes sont disponibles dans La section Affectation de noms d’un fichier et Limites de taille d’élément de registre.
parameterFileName	filePath	Chemin d’accès complet au fichier qui contient les ressources de chaîne de paramètre du fournisseur. Le fichier peut être un fichier exécutable ou un fichier DLL. Vous pouvez spécifier plusieurs fichiers de paramètres séparés par un point-virgule. Le fichier fait l’objet d’une recherche lorsque la chaîne de message d’un événement contient une chaîne de paramètre. Les paramètres vous permettent de fournir des chaînes d’insertion localisables. Pour plus d'informations, consultez la section Notes.
resourceFileName	Filepath	Chemin d’accès complet au fichier qui contient les ressources de métadonnées du fournisseur. Le fichier peut être un fichier exécutable ou un fichier DLL.
source		À usage interne uniquement.
symbole	CSymbolType	Symbole à utiliser pour référencer le GUID du fournisseur dans votre application. Le compilateur de messages (MC.exe) utilise le symbole pour créer une constante pour le GUID du fournisseur dans le fichier d’en-tête généré par le compilateur.
warnOnApplicationCompatibilityError	xs:boolean	À usage interne uniquement.

Notes

Le observateur d'événements Windows (Eventvwr.exe) utilise la chaîne de message localisée si elle est disponible ; sinon, elle utilise la chaîne de l’attribut name.

Les chemins d’accès pour resourceFileName, messageFileName et parameterFileName peuvent contenir des variables d’environnement. Si vous définissez une nouvelle variable d’environnement à utiliser dans le chemin d’accès, vous devez redémarrer l’ordinateur afin que le service de journal des événements puisse récupérer la nouvelle variable . sinon, le service ne pourra pas trouver les ressources de votre fournisseur.

La chaîne de message d’un événement peut contenir des chaînes d’insertion et des chaînes de paramètres. Une chaîne d’insertion est de la forme %n, où n est un index de base unique qui identifie un élément de données à partir du modèle de données de l’événement que vous souhaitez insérer dans le message. Une chaîne de paramètre (voir l’attribut parameterFileName ) est de la forme %%n, où n est l’identificateur d’un message dans la table de messages. Si la chaîne de message de l’événement contenait « %1 %%11 = %2 %%12 » et que les valeurs d’élément de données pour %1 et %2 étaient respectivement 8 et 2, et que les chaînes de paramètres pour %%11 et %%12 étaient respectivement « quarts » et « gallons », la chaîne mise en forme serait « 8 quarts = 2 gallons ».

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]

Partager via