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 | type | BESCHREIBUNG |
|---|---|---|
| channels | ChannelListType | Definiert eine Liste von Kanälen, an die Anbieter Ereignisse protokollieren können. |
| Ereignisse | DefinitionType | Definiert eine Liste von Ereignisdefinitionen der Ereignisse, die der Anbieter protokollieren kann. |
| Filter | FilterListType | Definiert eine Liste von Filtern, die ihr Anbieter unterstützt. Sie können die Filter wie bei den Schlüsselwörtern und verwenden, um zu bestimmen, ob Sie ein Ereignis schreiben möchten. Windows Server 2008 und Windows Vista: Wird erst ab 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 Name-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. |
| Aufgaben | TaskListType | Definiert eine Liste von Aufgaben, die ein Anbieter zum Gruppen von Ereignissen verwenden kann. In der Regel verwenden Sie Aufgaben, um Ereignisse für ein Feature oder eine Komponente des Anbieters zu gruppen. |
| Vorlagen | TemplateListType | Definiert eine Liste von Vorlagen, die die Daten angeben, die in die Ereignisse aufgenommen werden. |
Attributes
| Name | type | BESCHREIBUNG |
|---|---|---|
| guid | GUIDType | Eine GUID, die den Anbieter eindeutig identifiziert. |
| Helplink | anyURI | Die URL oder ms help link to content that provides information about the events that the provider raises. |
| message | strTableRef | Der lokalisierte Anzeigename für den Anbieter. Die Meldungszeichenfolge verweist auf eine lokalisierte Zeichenfolge im StringTable-Abschnitt 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 Formular Company Product Component - - (Unternehmensproduktkomponente) haben. Der Name darf nicht länger als 255 Zeichen sein und darf die folgenden Zeichen nicht enthalten: ">", "<", "&", ", " | ", \ ", ":", "", "?", " " oder Zeichen mit Codes kleiner * als 31. Darüber hinaus muss der Name den allgemeinen Einschränkungen für Datei- und Registrierungsschlüsselnamen folgen. Diese Einschränkungen finden Sie unter Naming a File (Benennen einer Datei)und Registry Element Size Limits (Größenbeschränkungen für Registrierungselemente). |
| parameterFileName | Filepath | Der vollständige Pfad zu der Datei, die die Parameterzeichenfolgenressourcen des Anbieters enthält. Die Datei kann eine ausführbare Datei oder DLL-Datei sein. Sie können mehrere Parameterdatei angeben, die durch ein Semikolon getrennt ist. Die Datei wird durchsucht, wenn die Meldungszeichenfolge eines Ereignisses eine Parameterzeichenfolge enthält. Mit 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 Headerdatei zu erstellen, die der Compiler generiert. |
| warnOnApplicationCompatibilityError | xs:boolean | Nur zur internen Verwendung. |
Bemerkungen
Der Windows Ereignisanzeige (Eventvwr.exe) verwendet die lokalisierte Meldungszeichenfolge, falls verfügbar. Andernfalls wird die Zeichenfolge aus dem Namensattribut 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 verwenden kann. Andernfalls kann der Dienst die Ressourcen Ihres Anbieters nicht finden.
Die Meldungszeichenfolge eines Ereignisses kann Einfügezeichenfolgen und Parameterzeichenfolgen enthalten. Eine Einfügezeichenfolge hat das Formular %n, wobei n ein 1-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 das Format %%n, wobei n der Bezeichner einer Nachricht in der Meldungstabelle ist. Wenn die Meldungszeichenfolge des Ereignisses "%1 %%11 = %2 %%12" enthält und die Datenelementwerte für %1 bzw. %2 8 bzw. 2 sind und die Parameterzeichenfolgen für %%11 bzw. %%12 "quarts" bzw. "quartns" sind, wäre die formatierte Zeichenfolge "8 quarts = 2 churns".
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |