Komplexer ProviderType-Typ

  • Artikel

Definiert einen Anbieter und die Metadaten, die er zum Definieren seiner Ereignisse verwendet.

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

Untergeordnete Elemente

Element Typ BESCHREIBUNG
Kanäle ChannelListType Definiert eine Liste von Kanälen, in denen Anbieter Ereignisse protokollieren können.
Ereignisse DefinitionType Definiert eine Liste der Ereignisdefinitionen der Ereignisse, die der Anbieter protokollieren kann.
Filter FilterListType Definiert eine Liste der Filter, die Ihr Anbieter unterstützt. Sie können die Filter wie Level und Schlüsselwörter verwenden, um zu bestimmen, ob Sie ein Ereignis schreiben möchten.
Windows Server 2008 und Windows Vista: Wird erst unter Windows 7 unterstützt.
Schlüsselwörter KeywordListType Definiert eine Liste von Schlüsselwörtern, die Ereignisse kategorisieren.
Ebenen LevelListType Definiert eine Liste von Ebenen, die den Schweregrad eines Ereignisses angeben.
Karten MapType Definiert eine Liste von Namen-Wert-Paaren, auf die Sie im Vorlagenabschnitt des Manifests verweisen können.
namedQueries NamedQueryType Wird nicht verwendet. Definiert eine Liste benannter Abfragen, die die Ereignismeldungszeichenfolge nach einem Wert abfragen und eine angegebene Aktion ausführen, falls gefunden.
Opcodes OpcodeListType Definiert eine Liste von Opcodes, die Sie zum Gruppieren von Ereignissen innerhalb einer Aufgabe verwenden können.
Tasks TaskListType Definiert eine Liste von Aufgaben, die ein Anbieter zum Gruppieren von Ereignissen verwenden kann. In der Regel verwenden Sie Aufgaben, um Ereignisse für ein Feature oder eine Komponente des Anbieters zu gruppieren.
Vorlagen TemplateListType Definiert eine Liste von Vorlagen, die die Daten angeben, die in die Ereignisse eingeschlossen werden sollen.

Attributes

Name Typ BESCHREIBUNG
guid GUIDType Eine GUID, die den Anbieter eindeutig identifiziert.
Helplink anyURI Die URL oder der MS-Hilfelink zu Inhalten, die Informationen zu den Ereignissen liefern, die der Anbieter auslöst.
message strTableRef Der lokalisierte Anzeigename für den Anbieter. Die Nachrichtenzeichenfolge verweist auf eine lokalisierte Zeichenfolge im Abschnitt stringTable des Manifests.
messageFileName filePath Der vollständige Pfad zu der Datei, die die lokalisierten Nachrichtenressourcen des Anbieters enthält. Die Datei kann eine ausführbare Datei oder DLL-Datei sein.
name anyURI Der Name des Anbieters. Der Name sollte das FormatUnternehmensproduktkomponente-- aufweisen.
Der Name darf nicht länger als 255 Zeichen sein und darf die Zeichen '>', '<', '&', '', '', '', '', '\', ':', '', '', '?', '*' oder Zeichen mit Codes von weniger als 31 enthalten. Darüber hinaus muss der Name den allgemeinen Einschränkungen für Datei- und Registrierungsschlüsselnamen entsprechen. Diese Einschränkungen finden Sie unter Benennen einer Datei und Größenbeschränkungen für Registrierungselemente.
parameterFileName filePath Der vollständige Pfad zur Datei, die die Parameterzeichenfolgenressourcen des Anbieters enthält. Die Datei kann eine ausführbare Datei oder DLL-Datei sein. Sie können mehrere Parameterdateien angeben, die durch ein Semikolon getrennt sind. Die Datei wird durchsucht, wenn die Nachrichtenzeichenfolge eines Ereignisses eine Parameterzeichenfolge enthält. Mithilfe von Parametern können Sie lokalisierbare Einfügezeichenfolgen bereitstellen. Weitere Informationen finden Sie unter Hinweise.
Resourcefilename filePath Der vollständige Pfad zu der Datei, die die Metadatenressourcen des Anbieters enthält. Die Datei kann eine ausführbare Datei oder DLL-Datei sein.
source Nur zur internen Verwendung.
Symbol CSymbolType Das Symbol, das verwendet werden soll, um auf die GUID des Anbieters in Ihrer Anwendung zu verweisen. Der Nachrichtencompiler (MC.exe) verwendet das Symbol, um eine Konstante für die GUID des Anbieters in der vom Compiler generierten Headerdatei zu erstellen.
warnOnApplicationCompatibilityError xs:boolean Nur zur internen Verwendung.

Bemerkungen

Das Windows-Ereignisanzeige (Eventvwr.exe) verwendet die lokalisierte Nachrichtenzeichenfolge, sofern verfügbar. Andernfalls wird die Zeichenfolge aus dem name-Attribut verwendet.

Die Pfade für resourceFileName, messageFileName und parameterFileName können Umgebungsvariablen enthalten. Wenn Sie eine neue Umgebungsvariable definieren, die im Pfad verwendet werden soll, müssen Sie den Computer neu starten, damit der Ereignisprotokolldienst die neue Variable aufnehmen kann. Andernfalls kann der Dienst die Ressourcen Ihres Anbieters nicht finden.

Die Nachrichtenzeichenfolge eines Ereignisses kann Einfügezeichenfolgen und Parameterzeichenfolgen enthalten. Eine Einfügezeichenfolge ist von der Form %n, wobei n ein n ein basierter Index ist, der ein Datenelement aus der Datenvorlage des Ereignisses identifiziert, das Sie in die Nachricht einfügen möchten. Eine Parameterzeichenfolge (siehe parameterFileName-Attribut ) hat die Form %%n, wobei n der Bezeichner einer Nachricht in der Nachrichtentabelle ist. Wenn die Nachrichtenzeichenfolge des Ereignisses "%1 %%%11 = %2 %%12" und die Datenelementwerte für %1 bzw. %2 8 bzw. 2 und die Parameterzeichenfolgen für %%11 und %%12 "Quarts" bzw. "Gallonen" wären, würde die formatierte Zeichenfolge "8 quarts = 2 Gallonen" sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 [nur Desktop-Apps]