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