Export (0) Print
Expand All

TemplateItemType Complex Type

A template that defines the data to include with an event.

<xs:complexType name="TemplateItemType">
    <xs:sequence
        maxOccurs="unbounded"
    >
        <xs:choice
            maxOccurs="unbounded"
            minOccurs="0"
        >
            <xs:element name="data"
                type="DataDefinitionType"
             />
            <xs:element name="struct"
                type="StructDefinitionType"
             />
        </xs:choice>
        <xs:element name="binary"
            minOccurs="0"
        >
            <xs:complexType>
                <xs:attribute name="name"
                    type="string"
                    use="optional"
                 />
            </xs:complexType>
        </xs:element>
        <xs:element name="UserData"
            type="XmlType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="tid"
        type="token"
        use="required"
     />
    <xs:attribute name="name"
        type="string"
        use="optional"
     />
</xs:complexType>

Child elements

ElementTypeDescription
binary

Reserved for internal use only.

data DataDefinitionType

Defines a data item that you want to include with the event.

struct StructDefinitionType

Defines a structure that includes one or more data items that you want to include with the event. Providers write the structure as a blob and not as individual members of the structure.

UserData XmlType

An XML fragment that is used to render the event data. If you do not include the fragment, the event data is rendered in the order that the data items are defined in the template. The contents of this element is any valid XML fragment. The fragment must contain only one top-level node and the top-level node must specify its own namespace.

To reference a data item in the fragment, set the text body for a node in the fragment to %n, where n is the one-based index of the top-level data items in the list of data items (you cannot reference members of a structure). The index value that you specify must not be greater than the number of top-level data items in the template.

This element follows all data and struct elements.

Attributes

NameTypeDescription
namestring

Reserved for internal use only.

namestring

The name of the template.

tidtoken

An identifier that uniquely identifies the template within the list of templates that the provider defines. Use this name to reference the template when you define your event definition.

Remarks

The template definition must have at least one data or struct child element. The provider must write the event data in the order of the data items defined in the template.

The size of all the data items in the template must be less than 64 KB.

Examples

The following example shows how to create a template definition.


<templates>
   <template tid="T1">
       <data name="PrinterName" intype="win:UnicodeString" />
       <UserData>
          <PrinterConnectionFailure 
              xmlns="schemas.microsoft.com/schemas/event/Microsoft.Windows.PrintSpooler/1.0.1.0/6382e26fc390d748">
              <PrinterName>%1</PrinterName>
          </PrinterConnectionFailure>
       </xml>
   </template>
</templates>

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

 

 

Community Additions

ADD
Show:
© 2014 Microsoft