Komplexer ProviderType-Typ

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]