instrumentationManifest-Element

  • Artikel

Der Stammknoten des Manifests.

<xs:element name="instrumentationManifest">
    <xs:complexType>
        <xs:complexContent>
            <xs:extension
                base="InstrumentationManifestType"
            >
                <xs:choice
                    maxOccurs="3"
                >
                    <xs:choice>
                        <xs:element name="metadata"
                            type="MetadataType"
                         />
                        <xs:element name="instrumentation"
                            type="InstrumentationType"
                         />
                    </xs:choice>
                    <xs:element name="localization"
                        type="LocalizationType"
                     />
                    <xs:any
                        processContents="lax"
                        minOccurs="0"
                        maxOccurs="unbounded"
                        namespace="##other"
                     />
                </xs:choice>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
</xs:element>

Untergeordnete Elemente

Element Typ BESCHREIBUNG
Instrumentation Instrumentationtype In diesem Abschnitt werden mindestens ein Ereignisanbieter und die von ihnen protokollierten Ereignisse definiert.
Lokalisierung LocalizationType In diesem Abschnitt werden die lokalisierten Nachrichtenzeichenfolgen definiert, die Consumer für die Anzeige verwenden. Dieser Abschnitt enthält beispielsweise die lokalisierte Nachrichtenzeichenfolge für den Namen Ihres Anbieters, die von Ihnen definierten Ereignisse und alle von Ihnen definierten Ereignisattribute, z. B. Kanäle, Aufgaben und Opcodes.
Metadaten MetadataType In diesem Abschnitt werden Metadatentypen definiert, die von anderen Manifesten verwendet werden können. Ein Beispiel finden Sie in der Winmeta.xml-Datei, die im Ordner \Include des Windows SDK enthalten ist.

Bemerkungen

Das instrumentationManifest-Element muss die folgenden Namespaces enthalten:

xmlns="https://schemas.microsoft.com/win/2004/08/events" xmlns:win="" xmlns:xs="https://www.w3.org/2001/XMLSchemahttps://manifests.microsoft.com/win/2004/08/windows/events"

Ein Manifest muss einen Instrumentierungsabschnitt und einen Lokalisierungsabschnitt enthalten. Der Instrumentierungsabschnitt und der Metadatenabschnitt schließen sich gegenseitig aus (Sie können beide nicht im selben Manifest definieren). Obwohl Sie ein Manifest erstellen können, das einen Metadatenabschnitt enthält, wird es vom Dienst nicht verwendet. die einzigen Metadaten, die der Dienst erkennt, sind die Metadaten, die in der Winmeta.xml datei gefunden wurden.

Beispiele

Das folgende Beispiel zeigt das Skelett eines vollständig definierten Instrumentierungsmanifests.

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events" 
    xmlns:win="https://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xs="https://www.w3.org/2001/XMLSchema"    
    >

    <instrumentation>
        <events>
            <provider ...>
                <channels>
                    <importChanel .../>
                    <channel .../>
                </channels>
                <levels>
                <level .../>
                </levels>
                <tasks>
                    <task .../>
                </tasks>
                <opcodes>
                    <opcode .../>
                </opcodes>
                <keywords>
                    <keyword .../>
                </keywords>
                <filters>
                    <filter .../>
                </filters>
                <maps>
                    <valueMap ...>
                        <map .../>
                    </valueMap>
                    <bitMap ...>
                        <map .../>
                    </bitMap>
                </maps>
                <namedQueries>
                    <patternMap ...>
                        <map .../>
                    </patternMap>  
                </namedQueries>
                <templates>
                    <template ...>
                        <data .../>
                        <UserData>
                            <!-- valid XML fragment -->
                        </UserData>
                    </template>
                </templates>
                <events>
                    <event .../>
                </events>
            </provider>
        </events>
    </instrumentation>

    <localization>
        <resources ...>
            <stringTable>
                <string .../>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>

Anforderungen

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