Condividi tramite

Classe LogFileEventConsumer

  • Articolo

La classe LogFileEventConsumer scrive stringhe personalizzate in un file di log di testo quando gli eventi vengono recapitati. Le stringhe sono separate da sequenze end-of-line. 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 LogFileEventConsumer : __EventConsumer
{
  uint8   CreatorSID[];
  string  MachineName;
  uint32  MaximumQueueSize;
  string  Filename;
  boolean IsUnicode;
  uint64  MaximumFileSize = 65535;
  string  Name;
  string  Text;
};

Members

La classe LogFileEventConsumer include questi tipi di membri:

Proprietà

La classe LogFileEventConsumer ha queste proprietà.

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.

Filename

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome di un file che include il percorso a cui vengono aggiunte le voci di log. Se il file non esiste, LogFileEventConsumer tenta di crearlo. Il consumer non riesce quando il percorso non esiste o quando l'utente che crea il consumer non dispone delle autorizzazioni di scrittura per il file o il percorso.

IsUnicode

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se TRUE, il file di log è un file di testo Unicode. Se FALSE, il file di log è un file di testo di codice multibyte. Se il file esiste, questa proprietà viene ignorata e viene usata l'impostazione del file corrente. Ad esempio, se IsUnicode è FALSE, ma il file esistente è un file Unicode, viene usato Unicode. Se IsUnicode è TRUE, ma il file è codice multibyte, viene usato il codice multibyte.

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.

Maximumfilesize

Tipo di dati: uint64

Tipo di accesso: sola lettura

Dimensioni massime di un file di log in byte. Se il file primario supera le dimensioni massime, il contenuto viene spostato in un file diverso e il file primario viene svuotato. Un valore pari a 0 (zero) indica che non esiste alcun limite di dimensioni. Il valore predefinito è 65.535 byte. Le dimensioni del file vengono controllate prima di un'operazione di scrittura. È pertanto possibile avere un file leggermente maggiore del limite di dimensioni specificato. L'operazione di scrittura successiva lo rileva e avvia un nuovo file.

L'elenco seguente identifica la struttura di denominazione per il file di backup:

  • Se il nome file originale è 8.3, l'estensione viene sostituita da una stringa nel formato "001", "002" e così via con il numero più piccolo maggiore di tutti i numeri usati e scelti in precedenza. Se viene usato "999", il numero scelto è il numero inutilizzato più piccolo.
  • Se il nome file originale non è 8.3, una stringa nel formato "001", "002" e così via viene aggiunta al nome del file.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

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 per questo consumer.

Text

Tipo di dati: stringa

Tipo di accesso: sola lettura

Modello stringa standard per il testo di una voce di log.

Commenti

Nota

LogFileEventConsumer non protegge il file di log. Pertanto, quando si configura LogFileEventConsumer, è importante specificare una directory protetta al livello richiesto.

La classe LogFileEventConsumer deriva dalla classe astratta __EventConsumer .

Esempio

Per un esempio di uso di LogFileEventConsumer per creare un consumer, vedere Scrittura in un file di log 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

Scrittura in un file di log basato su un evento

Creazione di un consumer logico

Ricezione di eventi in qualsiasi momento

__EventConsumer