InputType Complex Type

Definiert einen Eingabedatentyp.

<xs:complexType name="InputType">
    <xs:sequence>
        <xs:element name="description"
            type="string"
         />
        <xs:element name="outType"
            type="OutputType"
            minOccurs="0"
            maxOccurs="unbounded"
         />
        <xs:any
            processContents="lax"
            namespace="##other"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="QName"
        use="required"
     />
    <xs:attribute name="value"
        type="string"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="required"
     />
</xs:complexType>

Untergeordnete Elemente

Element type BESCHREIBUNG
Beschreibung Zeichenfolge Eine Beschreibung des Eingabetyps.
outType OutputType Eine Liste von Ausgabedatentypen, die bestimmen, wie die Daten gerendert werden. Sie müssen mindestens einen Ausgabetyp angeben. Geben Sie eine Liste an, wenn der Eingabetyp als unterschiedliche Ausgabetypen gerendert werden kann. Beispielsweise kann der Eingabetyp win:UInt16 als unsignierte Kurz-, Portnummer oder Hexadezimalzahl gerendert werden. Bei einem der von Ihnen angegebenen Ausgabetypen muss das Standardattribute auf true festgelegt sein.

Attributes

Name type BESCHREIBUNG
name QName Der Name des Eingabetyps.
Symbol CSymbolType Das Symbol, mit dem auf den Eingabetyp in Ihrer Anwendung verwiesen werden soll. Der Nachrichtencompiler (MC.exe) verwendet das Symbol, um eine Konstante für den Eingabetyp in der vom Compiler generierten Headerdatei zu erstellen.
value Zeichenfolge Ein numerischer Bezeichner, der den Eingabetyp in einer Liste der von Ihnen definierten Eingabetypen eindeutig identifiziert.

Bemerkungen

Im Folgenden werden die erkannten Eingabetypen aufgelistet, die Sie in Ihrem Manifest verwenden können. Die Typen werden in der \Include\Winmeta.xml-Datei definiert, die im Windows SDK enthalten ist. Die Spalte "Standard-XML-Format" gibt den kanonischen Typ für den spezifischen Eingabetyp an. In der Spalte "Ausgabetyp" werden die möglichen Formate aufgelistet, in denen die Daten gerendert werden können. Wenn Sie keinen Ausgabetyp für das Datenelement angeben, verwendet der Dienst den ersten aufgeführten Ausgabetyp, um die Daten zu rendern. Eine Beschreibung der Ausgabetypen finden Sie im komplexen OutputType-Typ .

In der folgenden Tabelle sind werte aufgeführt, die in der Winmeta.xml-Datei definiert sind.

Eingabetyp BESCHREIBUNG Ausgabetyp
win:AnsiString Eine Zeichenfolge mit 8-Bit-Zeichen. Standardmäßig oder bei Verwendung mit dem Ausgabetyp xs:string wird davon ausgegangen, dass die Zeichenfolge mithilfe der ANSI-Codepage des Ereignisanbieters codiert wurde. Bei Verwendung mit den Ausgabetypen win:Xml, win:Json oder win:Utf8 wird davon ausgegangen, dass die Zeichenfolge mit UTF-8 codiert wurde. xs:string,
win:Xml
Ab mc.exe Version 10.0.14251:
win:Json
win:Utf8
win:UnicodeString Eine Zeichenfolge mit 16-Bit-Zeichen. Standardmäßig wird angenommen, dass sie mit UTF-16LE codiert wurde. xs:string
win:Xml
Ab mc.exe Version 10.0.14251:
win:Json
win:Int8 Eine ganze 8-Bit-Zahl mit Vorzeichen. Bei Verwendung mit dem Ausgabetyp xs:string wird dies als Zeichen behandelt. xs:byte
Ab mc.exe Version 10.0.14251:
xs:string
win:UInt8 Eine 8-Bit-Ganzzahl ohne Vorzeichen. Bei Verwendung mit dem Ausgabetyp xs:string wird dies als Zeichen behandelt. xs:unsignedByte
Ab mc.exe Version 10.0.14251:
xs:string
win:Int16 Eine ganze 16-Bit-Zahl mit Vorzeichen. xs:short
win:UInt16 Eine 16-Bit-Ganzzahl ohne Vorzeichen. Bei Verwendung mit dem Ausgabetyp win:Port werden die Daten als big-endian (Netzwerkbytereihenfolge) behandelt. Bei Verwendung mit dem Ausgabetyp xs:string wird dies als Zeichen behandelt. xs:unsignedShort
win:Port
win:HexInt16
Ab mc.exe Version 10.0.14251:
xs:string
win:Int32 Eine 32-Bit-Ganzzahl mit Vorzeichen. xs:int
win:HResult
win:UInt32 Eine 32-Bit-Ganzzahl ohne Vorzeichen. xs:unsignedInt
win:PID
win:TID
win:IPv4
win:ETWTIME
win:Win32Error
win:NTSTATUS
win:HexInt32
win:Int64 Eine 64-Bit-Ganzzahl mit Vorzeichen. xs:long
win:UInt64 Eine 64-Bit-Ganzzahl ohne Vorzeichen. xs:unsignedLong
win:ETWTIME
win:HexInt64
win:Float Eine IEEE 4-Byte-Gleitkommazahl. xs:float
win:Double Eine IEEE-8-Byte-Gleitkommazahl. xs:double
win:Boolean Ein 32-Bit-Wert, wobei 0 false und 1 true ist. xs:boolean
win:Binary Binärdaten mit variabler Größe. Die Größe muss in der Datendefinition als Konstante oder als Verweis auf ein anderes (ganzzahliges) Datenelement angegeben werden. Bei einer IP-V6-Adresse sollten die Daten eine IN6_ADDR-Struktur sein.
Bei einer Socketadresse sollten die Daten eine SOCKADDR_STORAGE-Struktur sein. Die Adressfamilien AF_INET, AF_INET6 und AF_LINK werden unterstützt.
Ab mc.exe Version 10.0.14251 oder höher können Binärdaten den Ausgabetyp win:Pkcs7WithTypeInfo verwenden. Bei diesen Daten sollte es sich um eine PKCS#7-Nachricht (z. B. verschlüsselte und/oder signierte Daten) handelt. Auf die PKCS#7-Nachricht können optional Informationen zum TraceLogging-Typ folgen, die den Typ des inneren Inhalts angeben. Falls vorhanden, sollten die TraceLogging-Typinformationen sofort auf die PKCS#7-Nachricht folgen (d. h. die Typinformationen sind nicht im PKCS#7-Inhalt enthalten). Um den Eingabetyp des inneren Inhalts anzugeben, fügen Sie ein Byte mit einem Wert aus der TlgIn_t-Enumeration an (definiert in TraceLoggingProvider.h). Um die Eingabe- und Ausgabetypen des inneren Inhalts anzugeben, fügen Sie ein Byte mit einem Wert aus der TlgIn_t-Enumeration und dem hohen Bitsatz des Byte an, und fügen Sie ein zweites Byte mit einem Wert aus der TlgOut_t-Enumeration an.
xs:hexBinary
win:IPv6
win:SocketAddress
Ab mc.exe Version 10.0.14251 oder höher:
win:Pkcs7WithTypeInfo
win:GUID Eine GUID-Struktur . Bei der Ausgabe wird die GUID im Registrierungszeichenfolgenformular {xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx} gerendert. xs:GUID
win:Pointer Ein nicht signierter 32-Bit- oder 64-Bit-Zeigerwert. Die Größe hängt von der Architektur des Computers ab, der das Ereignis protokolliert. win:HexInt64
win:FILETIME Eine FILETIME-Struktur mit 8 Bytes. xs:dateTime
win:DateTimeCultureInsensitive
win:SYSTEMTIME Eine SYSTEMTIME-Struktur mit 16 Byte. xs:dateTime
win:DateTimeCultureInsensitive
win:SID Eine SID-Struktur (Security Identifier), die einen Benutzer oder eine Gruppe eindeutig identifiziert. Bei der Ausgabe wird die SID in Zeichenfolgenform mit der ConvertSidToStringSid-Funktion gerendert. xs:string
win:HexInt32 Hexadezimaldarstellung einer 32-Bit-Ganzzahl ohne Vorzeichen win:HexInt32
win:Win32Error
win:NTSTATUS
win:HexInt64 Eine hexadezimale Darstellung einer 64-Bit-Ganzzahl ohne Vorzeichen. win:HexInt64

Wenn Sie win:UInt32 zum Speichern einer IPv4-Adresse verwenden, muss der Wert in der Bytereihenfolge des Netzwerks erfolgen. Um eine IPv4-Adresszeichenfolge in eine ganze Zahl ohne Vorzeichen in Netzwerkbytereihenfolge zu konvertieren, rufen Sie die Funktion RtlIpv4StringToAddress oder inet_addr auf. Um die ganze Zahl ohne Vorzeichen in eine IPv4-Adresszeichenfolge zu konvertieren, rufen Sie die Funktion RtlIpv4AddressToString oder inet_ntoa auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]