TemplateItemType 複合型

イベントに含めるデータを定義するテンプレート。

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

子要素

要素	Type	説明
バイナリ		内部使用専用に予約されています。
データ	DataDefinitionType	イベントに含めるデータ項目を定義します。
構造 体	StructDefinitionType	イベントに含める 1 つ以上のデータ項目を含む構造体を定義します。 プロバイダーは、構造体を BLOB として書き込み、構造体の個々のメンバーとして書き込むわけではありません。
Userdata	XmlType	イベント データのレンダリングに使用される XML フラグメント。 フラグメントを含まない場合、イベント データは、データ項目がテンプレートで定義されている順序でレンダリングされます。 この要素の内容は、任意の有効な XML フラグメントです。 フラグメントには最上位ノードが 1 つだけ含まれている必要があり、最上位ノードは独自の名前空間を指定する必要があります。 フラグメント内のデータ項目を参照するには、フラグメント内のノードのテキスト本文を %n に設定します。 n は、データ項目のリスト内の最上位データ項目の 1 から始まるインデックスです (構造体のメンバーを参照することはできません)。 指定するインデックス値は、テンプレート内の最上位レベルのデータ項目の数を超えてはなりません。 この要素は、すべての データ 要素と 構造体 要素に従います。

属性

名前	型	説明
name	string	内部使用専用に予約されています。
name	string	テンプレートの名前。
tid	token	プロバイダーが定義するテンプレートの一覧内でテンプレートを一意に識別する識別子。 イベント定義を定義するときにテンプレートを参照するには、この名前を使用します。

注釈

テンプレート定義には、少なくとも 1 つのデータまたは構造体の子要素が必要です。 プロバイダーは、テンプレートで定義されているデータ項目の順序でイベント データを書き込む必要があります。

テンプレート内のすべてのデータ項目のサイズは、64 KB 未満である必要があります。

例

次の例は、テンプレート定義を作成する方法を示しています。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]