Tipo complesso ProviderType

Articolo
01/10/2024

Definisce un provider e i metadati usati per definirne gli eventi.

<xs:complexType name="ProviderType">
    <xs:choice
        minOccurs="0"
        maxOccurs="unbounded"
    >
        <xs:element name="channels"
            type="ChannelListType"
         />
        <xs:element name="levels"
            type="LevelListType"
         />
        <xs:element name="tasks"
            type="TaskListType"
         />
        <xs:element name="opcodes"
            type="OpcodeListType"
         />
        <xs:element name="keywords"
            type="KeywordListType"
         />
        <xs:element name="maps"
            type="MapType"
         />
        <xs:element name="namedQueries"
            type="NamedQueryType"
         />
        <xs:element name="templates"
            type="TemplateListType"
         />
        <xs:element name="events"
            type="DefinitionType"
         />
        <xs:element name="filters"
            type="FilterListType"
         />
        <xs:any
            processContents="lax"
            namespace="##other"
         />
    </xs:choice>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="guid"
        type="GUIDType"
        use="required"
     />
    <xs:attribute name="resourceFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="messageFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="parameterFileName"
        type="filePath"
        use="optional"
     />
    <xs:attribute name="helpLink"
        type="anyURI"
        use="optional"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="required"
     />
    <xs:attribute name="message"
        type="strTableRef"
        use="optional"
     />
    <xs:attribute name="source"
        use="optional"
        default="Xml"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="Xml"
                 />
                <xs:enumeration
                    value="Wbem"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="warnOnApplicationCompatibilityError"
        type="xs:boolean"
        use="optional"
        default="false"
     />
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

Elementi figlio

Elemento	Tipo	Descrizione
Canali	ChannelListType	Definisce un elenco di canali a cui i provider possono registrare gli eventi.
eventi	DefinitionType	Definisce un elenco di definizioni di eventi degli eventi che il provider può registrare.
filters	FilterListType	Definisce un elenco di filtri supportati dal provider. È possibile usare i filtri, come livellare e parole chiave, per determinare se si vuole scrivere un evento. Windows Server 2008 e Windows Vista: non supportato fino a Windows 7.
Parole chiavi	KeywordListType	Definisce un elenco di parole chiave che classificano gli eventi.
Livelli	LevelListType	Definisce un elenco di livelli che specificano la gravità di un evento.
Mappe	MapType	Definisce un elenco di coppie nome/valore a cui è possibile fare riferimento nella sezione modello del manifesto.
namedQueries	NamedQueryType	Non utilizzato. Definisce un elenco di query denominate che eseguono una query sulla stringa del messaggio di evento per un valore ed eseguono un'azione specificata, se presente.
Opcodes	OpcodeListType	Definisce un elenco di codici operativo che è possibile usare per raggruppare gli eventi all'interno di un'attività.
Attività	TaskListType	Definisce un elenco di attività che un provider può usare per raggruppare gli eventi. In genere, si usano attività per raggruppare eventi per una funzionalità o un componente del provider.
templates	TemplateListType	Definisce un elenco di modelli che specificano i dati da includere con gli eventi.

Attributi

Nome	Tipo	Descrizione
guid	GUIDType	GUID che identifica in modo univoco il provider.
Helplink	anyURI	Collegamento della Guida di URL o MS al contenuto che fornisce informazioni sugli eventi generati dal provider.
messaggio	strTableRef	Nome visualizzato localizzato per il provider. La stringa del messaggio fa riferimento a una stringa localizzata nella sezione stringTable del manifesto.
messageFileName	filePath	Percorso completo del file contenente le risorse del messaggio localizzate del provider. Il file può essere un file eseguibile o un file DLL.
name	anyURI	Nome del provider. Il nome deve essere del formato, Company-Product-Component. Il nome non può contenere più di 255 caratteri e non può contenere i caratteri: '>', '<', '&', '',', '\|', '\', ':', '', '?', '*' o caratteri con codici inferiori a 31. Inoltre, il nome deve seguire i vincoli generali sui nomi di chiave del file e del Registro di sistema. Questi vincoli sono disponibili in Naming a File (Denominazione di un file) e Registry Element Size Limits (Limiti delle dimensioni degli elementi del Registro di sistema).
parameterFileName	filePath	Percorso completo del file che contiene le risorse della stringa di parametri del provider. Il file può essere un file eseguibile o un file DLL. È possibile specificare più file di parametri separati da un punto e virgola. Il file viene cercato quando la stringa di messaggio di un evento contiene una stringa di parametro. I parametri consentono di specificare stringhe di inserimento localizzabili. Vedere osservazioni Per ulteriori informazioni.
resourceFileName	filePath	Percorso completo del file contenente le risorse dei metadati del provider. Il file può essere un file eseguibile o un file DLL.
source		Solo per uso interno.
simbolo	CSymbolType	Simbolo da usare per fare riferimento al GUID del provider nell'applicazione. Il compilatore di messaggi (MC.exe) usa il simbolo per creare una costante per il GUID del provider nel file di intestazione generato dal compilatore.
warnOnApplicationCompatibilityError	xs:boolean	Solo per uso interno.

Osservazioni:

L'Visualizzatore eventi di Windows (Eventvwr.exe) utilizzerà la stringa di messaggio localizzata, se disponibile; in caso contrario, usa la stringa dell'attributo name.

I percorsi per resourceFileName, messageFileName e parameterFileName possono contenere variabili di ambiente. Se si definisce una nuova variabile di ambiente da usare nel percorso, è necessario riavviare il computer in modo che il servizio registro eventi possa raccogliere la nuova variabile; in caso contrario, il servizio non sarà in grado di trovare le risorse del provider.

La stringa di messaggio di un evento può contenere stringhe di inserimento e stringhe di parametri. Una stringa di inserimento è nel formato %n, dove n è un indice in base uno che identifica un elemento di dati dal modello di dati dell'evento che si desidera inserire nel messaggio. Una stringa di parametro (vedere l'attributo parameterFileName ) è nel formato %%n, dove n è l'identificatore di un messaggio nella tabella dei messaggi. Se la stringa di messaggio dell'evento contiene "%1 %%11 = %2 %%12" e i valori dell'elemento di dati per %1 e %2 sono rispettivamente 8 e 2 e le stringhe di parametro per %%11 e %%12 sono "quarts" e "galloni", rispettivamente, la stringa formattata sarà "8 quarts = 2 galloni".

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]

Condividi tramite