InputType Complex Type

Artikel
06/13/2023

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]

Freigeben über