Type complexe TemplateItemType

Article
06/13/2023

Modèle qui définit les données à inclure dans un événement.

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

Éléments enfants

Élément	Type	Description
Binaire		Réservé à un usage interne uniquement.
Données	DataDefinitionType	Définit un élément de données que vous souhaitez inclure dans l’événement.
Struct	StructDefinitionType	Définit une structure qui inclut un ou plusieurs éléments de données que vous souhaitez inclure avec l’événement. Les fournisseurs écrivent la structure en tant qu’objet blob et non en tant que membres individuels de la structure.
Userdata	XmlType	Fragment XML utilisé pour afficher les données d’événement. Si vous n’incluez pas le fragment, les données d’événement sont rendues dans l’ordre dans lequel les éléments de données sont définis dans le modèle. Le contenu de cet élément est n’importe quel fragment XML valide. Le fragment doit contenir un seul nœud de niveau supérieur et le nœud de niveau supérieur doit spécifier son propre espace de noms. Pour référencer un élément de données dans le fragment, définissez le corps du texte d’un nœud dans le fragment sur %n, où n est l’index de base unique des éléments de données de niveau supérieur dans la liste des éléments de données (vous ne pouvez pas référencer les membres d’une structure). La valeur d’index que vous spécifiez ne doit pas être supérieure au nombre d’éléments de données de niveau supérieur dans le modèle. Cet élément suit tous les éléments de données et de struct .

Attributs

Nom	Type	Description
name	string	Réservé à un usage interne uniquement.
name	string	Nom du modèle.
tid	token	Identificateur qui identifie de manière unique le modèle dans la liste des modèles définis par le fournisseur. Utilisez ce nom pour référencer le modèle lorsque vous définissez votre définition d’événement.

Notes

La définition du modèle doit avoir au moins un élément enfant de données ou de struct. Le fournisseur doit écrire les données d’événement dans l’ordre des éléments de données définis dans le modèle.

La taille de tous les éléments de données dans le modèle doit être inférieure à 64 Ko.

Exemples

L’exemple suivant montre comment créer une définition de modèle.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]

Partager via