Condividi tramite

Tipo complesso QueryType

  • Articolo

Definisce un set di query selettore e soppressore usate per includere eventi in o escludere eventi dal set di risultati.

<xs:complexType name="QueryType">
    <xs:choice
        maxOccurs="unbounded"
    >
        <xs:element name="Select">
            <xs:complexType
                mixed="true"
            >
                <xs:attribute name="Path"
                    type="anyURI"
                 />
            </xs:complexType>
        </xs:element>
        <xs:element name="Suppress">
            <xs:complexType
                mixed="true"
            >
                <xs:attribute name="Path"
                    type="anyURI"
                 />
            </xs:complexType>
        </xs:element>
    </xs:choice>
    <xs:attribute name="Id"
        type="long"
        use="optional"
     />
    <xs:attribute name="Path"
        type="anyURI"
        use="optional"
     />
</xs:complexType>

Elementi figlio

Elemento Tipo Descrizione
Selezionare Query XPath che identifica gli eventi da includere nel set di risultati della query. Specificare XPath nel corpo del testo di questo elemento. XPath è limitato a 32 espressioni.
Elimina Query XPath che identifica gli eventi da escludere dal set di risultati della query. Specificare XPath nel corpo del testo di questo elemento. XPath è limitato a 32 espressioni.

Attributi

Nome Tipo Descrizione
ID long Identificatore che identifica in modo univoco questa query nell'elenco di query. L'identificatore è basato su zero. È necessario specificare un identificatore se l'elenco di query contiene più query.
Percorso anyURI Nome del canale o del percorso del file di log contenente gli eventi.
Percorso anyURI Nome del canale o del percorso del file di log contenente gli eventi.
Percorso anyURI Non usato.

Commenti

La query deve avere almeno un'istruzione select. Per ogni istruzione di eliminazione, deve essere presente almeno un'istruzione select che specifica lo stesso percorso. Se la query seleziona e elimina restituisce gli stessi eventi, l'istruzione delete ha la precedenza. Se si selezionano eventi da più origini, gli eventi vengono restituiti nell'ordine di timestamp. Se si usa il timestamp di sistema e la frequenza degli eventi è elevata, è possibile che più eventi abbiano lo stesso timestamp. Quando si verifica questo problema, l'ordinamento degli eventi diventa ambiguo e gli eventi possono apparire non ordinati.

Se si specifica un percorso per una delle query nell'elenco di query, tutte le query devono specificare un percorso. Se non si specifica un percorso per tutte le query, è necessario specificare il percorso quando si chiama la funzione EvtQuery o EvtSubscribe .

Requisiti

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