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	Description
이진		이 속성은 내부 전용으로 예약되어 있으므로
데이터	DataDefinitionType	이벤트에 포함할 데이터 항목을 정의합니다.
구조체	StructDefinitionType	이벤트에 포함하려는 하나 이상의 데이터 항목을 포함하는 구조를 정의합니다. 공급자는 구조를 구조체의 개별 멤버가 아닌 Blob으로 작성합니다.
Userdata	XmlType	이벤트 데이터를 렌더링하는 데 사용되는 XML 조각입니다. 조각을 포함하지 않으면 데이터 항목이 템플릿에 정의된 순서대로 이벤트 데이터가 렌더링됩니다. 이 요소의 내용은 유효한 XML 조각입니다. 조각에는 최상위 노드가 하나만 포함되어야 하며 최상위 노드는 자체 네임스페이스를 지정해야 합니다. 조각에서 데이터 항목을 참조하려면 조각의 노드에 대한 텍스트 본문을 %n으로 설정합니다. 여기서 n 은 데이터 항목 목록에서 최상위 데이터 항목의 1 기반 인덱스입니다(구조체의 멤버를 참조할 수 없음). 지정하는 인덱스 값은 템플릿의 최상위 데이터 항목 수보다 크지 않아야 합니다. 이 요소는 모든 데이터 및 구조체 요소를 따릅니다.

특성

이름	형식	Description
name	문자열	이 속성은 내부 전용으로 예약되어 있으므로
name	문자열	템플릿의 이름입니다.
tid	token	공급자가 정의하는 템플릿 목록 내에서 템플릿을 고유하게 식별하는 식별자입니다. 이벤트 정의를 정의할 때 이 이름을 사용하여 템플릿을 참조합니다.

설명

템플릿 정의에는 하나 이상의 데이터 또는 구조체 자식 요소가 있어야 합니다. 공급자는 템플릿에 정의된 데이터 항목 순서대로 이벤트 데이터를 작성해야 합니다.

템플릿의 모든 데이터 항목 크기는 64KB 미만이어야 합니다.

예제

다음 예제에서는 템플릿 정의를 만드는 방법을 보여줍니다.

<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 [데스크톱 앱만 해당]