classe __EventFilter

La registrazione di un consumer di eventi permanente richiede un'istanza della classe di sistema __EventFilter .

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non in ordine MOF.

Sintassi

class __EventFilter : __IndicationRelated
{
  uint8  CreatorSID[] = {1,1,0,0,0,0,0,5,18,0,0,0};
  string EventAccess;
  string EventNamespace;
  string Name;
  string Query;
  string QueryLanguage;
};

Membri

La classe __EventFilter ha questi tipi di membri:

• Proprietà

Proprietà

La classe __EventFilter ha queste proprietà.

CreatorSID

Tipo di dati: matrice uint8

Tipo di accesso: lettura/scrittura

Identificatore di sicurezza (SID) che identifica in modo univoco l'utente che crea questo filtro. Strumentazione gestione Windows archivia il SID dell'utente che crea un'istanza di __EventFilter o il SID Amministrazione istrator, a seconda del sistema operativo. Per altre informazioni, vedere Associazione di un filtro eventi con un consumer logico e monitoraggio e risposta agli eventi con consumer standard.

EventAccess

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Descrittore di sicurezza (SD) in Security Descriptor Definition Language (SDDL) che controlla l'accesso agli eventi recapitati al filtro. Utilizzare questa proprietà per specificare che solo gli eventi nel contesto di sicurezza di account specifici possono essere recapitati a questo filtro. Ad esempio, un consumer di eventi permanente può cancellare i log di sicurezza solo quando un evento specifico viene generato da un utente specifico. Per specificare chi può pubblicare eventi in questo filtro, utilizzare la maschera WBEM_RIGHT_PUBLISH nella Controllo di accesso Voce (ACE) per la proprietà edizione StandardCURITY_DESCRIPTOR. Per altre informazioni, vedere Security Descriptor Definition Language. Per altre informazioni sulle costanti usate per impostare questo descrittore di sicurezza, vedere Costanti di sicurezza WMI. Per altre informazioni ed esempi, vedere replace:Receiving Events Securely.

È possibile configurare un descrittore di sicurezza dell'accesso agli eventi per consentire il recapito di un evento solo quando l'account di sistema locale genera l'evento. Per altre informazioni sulla creazione del descrittore di sicurezza e sull'autorizzazione dell'accesso, vedere Controllo di accesso.

Esempio: la stringa SDDL seguente consente solo agli amministratori di fornire eventi al filtro. Il diritto necessario per fornire gli eventi è WBEM_RIGHT_PUBLISH (x80).

O:BAG:BAD:(A;;0x80;;;BA)

EventNamespace

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Spazio dei nomi dell'istanza dell'evento usato per le sottoscrizioni tra spazi dei nomi.

Nome

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Qualificatori: Chiave

Identificatore univoco di un filtro eventi. Poiché un filtro eventi viene usato internamente solo da WMI, è consigliabile impostare questa proprietà su un identificatore univoco globale (GUID) convertito in una stringa. Tuttavia, i consumer possono usare qualsiasi schema privato per un nome di filtro purché non si verifichi un conflitto con altri filtri.

Query

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Query di eventi WQL (Windows Management Instrumentation Query Language) che specifica il set di eventi per la notifica consumer e le condizioni specifiche per la notifica.

QueryLanguage

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Linguaggio usato per la query. Poiché WMI supporta attualmente solo WQL (WMI Query Language) come linguaggio di query, questa proprietà deve essere impostata su "WQL".

Osservazioni:

La classe __EventFilter deriva da __IndicationRelated.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Tutti gli spazi dei nomi WMI

Vedi anche

__IndicationRelated

Classi di sistema WMI

Creazione di un filtro eventi

Ricezione di eventi in qualsiasi momento

Monitoraggio e risposta agli eventi con consumer standard

Monitoraggio degli eventi

Classi consumer standard

Protezione degli eventi WMI