StructDefinitionType 复杂类型

定义一个 结构,该结构包含要包含在事件中的一个或多个数据项。

<xs:complexType name="StructDefinitionType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="data"
            type="DataDefinitionType"
            maxOccurs="unbounded"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="string"
        use="required"
     />
    <xs:attribute name="length"
        type="LengthType"
        use="optional"
     />
    <xs:attribute name="count"
        type="CountType"
        use="optional"
     />
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

子元素

元素 类型 说明
数据 DataDefinitionType 定义要包含在 结构中的数据项。

属性

名称 类型 说明
count CountType 结构数组中的元素数。 此属性指示结构正在定义结构数组。 可以在包含计数的结构之外指定实际计数或数据项的名称。
length LengthType 不可用。
Windows Server 2008 和 Windows Vista: 此结构的长度(以字节为单位)。 从 Windows 7 开始不可用。
name string 结构的名称。 如果在模板中指定 UserData 节,则可以使用该名称引用 XML 片段中的数据项。
Windows Vista: 此属性是可选的。

备注

提供程序将结构编写为 blob 而不是结构的单个成员。 如果要编写的 C 结构包含指针 (例如,LPWSTR) 类型的指针,则事件数据将包含指针值,而不是取消引用的数据。

不应使用结构,而应为每个成员定义数据项并单独写入。 如果决定使用 结构,则结构应仅包含整型类型,并且必须确保结构的成员与 8 字节边界对齐。 如果不这样做,在尝试访问数据时,可能会收到对齐错误。 请考虑使用 #pragma pack () 指令在 8 字节边界上强制对齐。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]