Classe NTEventLogEventConsumer

La classe NTEventLogEventConsumer registra un messaggio specifico al registro eventi del sistema operativo quando viene recapitato un evento. Questa classe è uno dei consumer di eventi standard forniti da WMI. Per altre informazioni, vedere Monitoraggio e risposta agli eventi con consumer standard.

Sintassi

[AMENDMENT]
class NTEventLogEventConsumer : __EventConsumer
{
  uint8  CreatorSID[];
  string MachineName;
  uint32 MaximumQueueSize;
  uint16 Category;
  string NameOfRawDataProperty;
  uint32 EventID;
  uint32 EventType = 1;
  string InsertionStringTemplates[] = {""};
  string Name;
  uint32 NumberOfInsertionStrings = 0;
  string NameOfUserSidProperty;
  string SourceName;
  string UNCServerName;
};

Members

La classe NTEventLogEventConsumer include questi tipi di membri:

• Proprietà

Proprietà

La classe NTEventLogEventConsumer ha queste proprietà.

Categoria

Tipo di dati: uint16

Tipo di accesso: sola lettura

Categoria di eventi. Si tratta di informazioni specifiche dell'origine e possono avere qualsiasi valore.

CreatorSID

Tipo di dati: matrice uint8

Tipo di accesso: sola lettura

Identificatore di sicurezza (SID) che identifica in modo univoco l'utente che crea un filtro. WMI archivia il SID dell'utente che crea un'istanza di __EventConsumer o il SID amministratore, 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.

Questa proprietà viene ereditata da __EventConsumer.

EventID

Tipo di dati: uint32

Tipo di accesso: sola lettura

Messaggio di evento nella DLL del messaggio. Questa proprietà non può essere NULL.

EventType

Tipo di dati: uint32

Tipo di accesso: sola lettura

Tipo di evento. Questo parametro può avere uno dei valori elencati nell'elenco seguente, definito in Winnt.h.

EVENTLOG_SUCCESS (0 (0x0))

Evento riuscito

EVENTLOG_ERROR_TPYE (1 (0x1))

Evento di errore

EVENTLOG_WARNING_TYPE (2 (0x2))

Evento di avviso

EVENTLOG_INFORMATION_TYPE (4 (0x4))

Evento informativo

EVENTLOG_AUDIT_SUCCESS (8 (0x8))

Tipo di controllo riuscito

EVENTLOG_AUDIT_FAILURE (16 (0x10))

Tipo di controllo degli errori

InsertStringTemplates

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di modelli di stringa standard usati come stringa di inserimento per un record del registro eventi.

MachineName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome del computer a cui Windows Management Instrumentation (WMI) invia eventi.

Questa proprietà viene ereditata da __EventConsumer.

MaximumQueueSize

Tipo di dati: uint32

Tipo di accesso: sola lettura

Coda massima per un consumer specifico, in byte.

Questa proprietà viene ereditata da __EventConsumer.

Nome

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: chiave

Nome univoco di un consumer.

NameOfRawDataProperty

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome della proprietà evento che contiene dati da passare al parametro lpRawData della funzione ReportEvent.

NameOfUserSidProperty

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome della proprietà evento che contiene un identificatore di sicurezza (SID) da passare al parametro lpUserSid della funzione ReportEvent. La proprietà deve essere una matrice di byte (uint8) o una stringa. Se si tratta di una matrice di byte, si presuppone che sia un SID. Se si tratta di una stringa, si tratta di un SID stringa convertito in un SID.

NumberOfInsertionStrings

Tipo di dati: uint32

Tipo di accesso: sola lettura

Numero di elementi nella matrice InsertStringTemplates .

SourceName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome origine in cui si trova un messaggio. Si presuppone che il cliente abbia registrato una DLL con i messaggi necessari.

Nota

Il valore di questo parametro non deve includere due punti (:) Carattere.

UNCServerName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome del computer in cui registrare un evento o NULL se l'evento deve essere connesso in un server locale.

Gli utenti autenticati non possono, per impostazione predefinita, registrare gli eventi nel log dell'applicazione in un computer remoto. Di conseguenza, l'uso di questa proprietà per specificare un computer remoto non funzionerà. Per informazioni su come modificare la sicurezza del registro eventi, vedere questo articolo della Knowledge Base.

Commenti

La classe NTEventLogEventConsumer deriva dalla classe astratta __EventConsumer .

Esempio

Per un esempio di uso di NTEventLogEventConsumer per creare un consumer, vedere Registrazione nel registro eventi NT basato su un evento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\subscription
MOF	Wbemcons.mof
DLL	Wbemcons.dll

Vedi anche

Classi consumer standard

Creazione di un consumer logico

Ricezione di eventi in qualsiasi momento

__EventConsumer