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 [デスクトップ アプリのみ]