Tipo complesso InputType
Definisce un tipo di dati di input.
<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>
Elementi figlio
Elemento | Tipo | Descrizione |
---|---|---|
Descrizione | string | Descrizione del tipo di input. |
outType | OutputType | Elenco di tipi di dati di output che determinano il rendering dei dati. È necessario specificare almeno un tipo di output. Specificare un elenco se è possibile eseguire il rendering del tipo di input come tipi di output diversi. Ad esempio, il tipo di input win:UInt16 può essere sottoposto a rendering come numero breve, numero di porta o numero esadecimale senza segno. Uno dei tipi di output specificati deve avere l'attributo predefinito impostato su true. |
Attributi
Nome | Tipo | Descrizione |
---|---|---|
name | QName | Nome del tipo di input. |
simbolo | CSymbolType | Simbolo da usare per fare riferimento al tipo di input nell'applicazione.
Il compilatore di messaggi (MC.exe) usa il simbolo per creare una costante per il tipo di input nel file di intestazione generato dal compilatore. |
Valore | string | Identificatore numerico che identifica in modo univoco il tipo di input in un elenco di tipi di input definiti dall'utente. |
Commenti
Di seguito sono elencati i tipi di input riconosciuti che è possibile usare nel manifesto. I tipi sono definiti nel file \Include\Winmeta.xml incluso in Windows SDK. La colonna "Formato XML standard" indica il tipo canonico per il tipo di input specifico. La colonna "Tipo di output" elenca i formati possibili in cui è possibile eseguire il rendering dei dati. Se non si specifica un tipo di output per l'elemento di dati, il servizio userà il primo tipo di output elencato per eseguire il rendering dei dati. Per una descrizione dei tipi di output, vedere il tipo complesso OutputType .
Nella tabella seguente sono elencati i valori definiti nel file Winmeta.xml.
Tipo di input | Descrizione | Tipo di output |
---|---|---|
win:AnsiString | Stringa di caratteri a 8 bit. Per impostazione predefinita o quando viene usato con il tipo di output xs:string, si presuppone che la stringa sia stata codificata usando la tabella codici ANSI del provider di eventi. Se usato con i tipi di output win:Xml, win:Json o win:Utf8, si presuppone che la stringa sia stata codificata con UTF-8. | xs:string, win:Xml A partire da mc.exe versione 10.0.14251 o successiva: win:Json win:Utf8 |
win:UnicodeString | Stringa di caratteri a 16 bit. Per impostazione predefinita, si presuppone che sia stata codificata con UTF-16LE. | xs:string win:Xml A partire da mc.exe versione 10.0.14251 o successiva: win:Json |
win:Int8 | Intero con segno a 8 bit. Se usato con il tipo di output xs:string, questo verrà considerato come un carattere. | xs:byte A partire da mc.exe versione 10.0.14251 o successiva: xs:string |
win:UInt8 | Unsigned Integer a 8 bit. Se usato con il tipo di output xs:string, questo verrà considerato come un carattere. | xs:unsignedByte A partire da mc.exe versione 10.0.14251 o successiva: xs:string |
win:Int16 | Valore intero a 16 bit con segno. | xs:short |
win:UInt16 | Intero senza segno a 16 bit. Se usato con il tipo di output win:Port, i dati vengono considerati big-endian (ordine dei byte di rete). Se usato con il tipo di output xs:string, questo verrà considerato come un carattere. | xs:unsignedShort win:Port win:HexInt16 A partire da mc.exe versione 10.0.14251 o successiva: xs:string |
win:Int32 | Valore intero a 32 bit con segno. | xs:int win:HResult |
win:UInt32 | Intero senza segno a 32 bit. | xs:unsignedInt win:PID win:TID win:IPv4 win:ETWTIME win:Win32Error win:NTSTATUS win:HexInt32 |
win:Int64 | Valore intero a 64 bit con segno. | xs:long |
win:UInt64 | Intero senza segno a 64 bit. | xs:unsignedLong win:ETWTIME win:HexInt64 |
win:Float | Numero a virgola mobile IEEE a 4 byte. | xs:float |
win:Double | Numero a virgola mobile IEEE a 8 byte. | xs:double |
win:Boolean | Valore a 32 bit in cui 0 è false e 1 è true. | xs:boolean |
win:Binary | Dati binari di dimensioni variabili. Le dimensioni devono essere specificate nella definizione dei dati come costante o come riferimento a un altro elemento di dati (integer). Per un indirizzo IP V6, i dati devono essere una struttura IN6_ADDR . Per un indirizzo socket, i dati devono essere una struttura SOCKADDR_STORAGE. Sono supportate le famiglie di indirizzi AF_INET, AF_INET6 e AF_LINK. A partire da mc.exe versione 10.0.14251 o successiva, i dati binari possono usare il tipo di output win:Pkcs7WithTypeInfo. Questi dati devono essere un messaggio PKCS#7 ,ad esempio i dati crittografati e/o firmati. Il messaggio PKCS#7 può essere seguito facoltativamente da informazioni sul tipo TraceLogging che indica il tipo di contenuto interno. Se presente, le informazioni sul tipo TraceLogging devono seguire immediatamente il messaggio PKCS#7, ad esempio le informazioni sul tipo non sono incluse nel contenuto PKCS#7. Per specificare il tipo di input del contenuto interno, aggiungere un byte con un valore dell'enumerazione TlgIn_t (definita in TraceLoggingProvider.h). Per specificare i tipi di input e output del contenuto interno, aggiungere un byte con un valore dell'enumerazione TlgIn_t e con il set di bit elevato dei byte e aggiungere un secondo byte con un valore dell'enumerazione TlgOut_t. |
xs:hexBinary win:IPv6 win:SocketAddress A partire da mc.exe versione 10.0.14251 o successiva: win:Pkcs7WithTypeInfo |
win:GUID | Struttura GUID . Nell'output viene eseguito il rendering del GUID nel formato stringa del Registro di sistema , {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}. | xs:GUID |
win:Pointer | Valore del puntatore a 32 bit o a 64 bit senza segno. Le dimensioni dipendono dall'architettura del computer che registra l'evento. | win:HexInt64 |
win:FILETIME | Struttura FILETIME , 8 byte. | xs:dateTime win:DateTimeCultureInsensitive |
win:SYSTEMTIME | Struttura SYSTEMTIME , 16 byte. | xs:dateTime win:DateTimeCultureInsensitive |
win:SID | Struttura SID (Security Identifier) che identifica in modo univoco un utente o un gruppo. Nell'output viene eseguito il rendering del SID in formato stringa usando la funzione ConvertSidToStringSid . | xs:string |
win:HexInt32 | Rappresentazione esadecimale di un intero senza segno a 32 bit | win:HexInt32 win:Win32Error win:NTSTATUS |
win:HexInt64 | Rappresentazione esadecimale di un intero senza segno a 64 bit. | win:HexInt64 |
Se si usa win:UInt32 per archiviare un indirizzo IPv4, il valore deve essere in ordine di byte di rete. Per convertire una stringa di indirizzo IPv4 in un intero senza segno in ordine di byte di rete, chiamare la funzione RtlIpv4StringToAddress o inet_addr . Per convertire l'intero senza segno in una stringa di indirizzo IPv4, chiamare la funzione RtlIpv4AddressToString o inet_ntoa .
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows Vista [solo app desktop] |
Server minimo supportato |
Windows Server 2008 [solo app desktop] |