Compartilhar via


Classe LogFileEventConsumer

A classe LogFileEventConsume grava cadeias de caracteres personalizadas em um arquivo de log de texto quando os eventos são entregues a ela. As cadeias de caracteres são separadas por sequências de fim de linha. Essa classe é um dos consumidores de eventos padrão que o WMI oferece. Para obter mais informações, confira Como monitorar e responder a eventos com consumidores padrão.

Sintaxe

[AMENDMENT]
class LogFileEventConsumer : __EventConsumer
{
  uint8   CreatorSID[];
  string  MachineName;
  uint32  MaximumQueueSize;
  string  Filename;
  boolean IsUnicode;
  uint64  MaximumFileSize = 65535;
  string  Name;
  string  Text;
};

Membros

A classe LogFileEventConsumer tem estes tipos de membros:

Propriedades

A classe LogFileEventConsumer tem estas propriedades.

CreatorSID

Tipo de dados: matriz uint8

Tipo de acesso: Somente leitura

SID (identificador de segurança) que identifica exclusivamente o usuário que cria um filtro. O WMI armazena o SID do usuário que cria uma instância de __EventConsumer ou o SID do Administrador, dependendo do sistema operacional. Para obter mais informações, confira Como associar um filtro de evento com um consumidor lógico e Como monitorar e responder a eventos com consumidores padrão.

Essa propriedade é herdada de __EventConsumer.

Filename

Tipo de dados: string

Tipo de acesso: Somente leitura

Nome de um arquivo que inclui o caminho ao qual as entradas de log são acrescentadas. Se o arquivo não existir, o LogFileEventConsumer tentará criá-lo. O consumidor falha quando o caminho não existe ou quando o usuário que cria o consumidor não tem permissões de gravação para o arquivo ou caminho.

IsUnicode

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o arquivo de log será um arquivo de texto Unicode. Se FALSE, o arquivo de log será um arquivo de texto de código multibyte. Se o arquivo existir, essa propriedade será ignorada e a configuração do arquivo atual será usada. Por exemplo, se IsUnicode for FALSE, mas o arquivo existente for um arquivo Unicode, o Unicode será usado. Se IsUnicode for TRUE, mas o arquivo for um código multibyte, o código multibyte será usado.

MachineName

Tipo de dados: string

Tipo de acesso: Somente leitura

Nome do computador para o qual o WMI (Instrumentação de Gerenciamento do Windows) envia eventos.

Essa propriedade é herdada de __EventConsumer.

MaximumFileSize

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tamanho máximo de um arquivo de log em bytes. Se o arquivo primário exceder o tamanho máximo, o conteúdo será movido para um arquivo diferente e o arquivo primário será esvaziado. Um valor igual a zero (0) indica que não há limite. O valor padrão é 65.535 bytes. O tamanho do arquivo é verificado antes de uma operação de gravação. Portanto, você pode ter um arquivo ligeiramente maior que o limite de tamanho especificado. A próxima operação de gravação obtém essa informação e inicia um novo arquivo.

A lista a seguir identifica a estrutura de nomenclatura do arquivo de backup:

  • Se o nome de arquivo original for 8.3, a extensão será substituída por uma cadeia de caracteres no formato "001", "002" e assim por diante, com o menor número maior do que todos os números usados e escolhidos anteriormente. Se for usado "999", o número escolhido será o menor número não utilizado.
  • Se o nome de arquivo original não for 8.3, uma cadeia de caracteres no formato "001", "002" e assim por diante será acrescentada ao nome do arquivo.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

MaximumQueueSize

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Fila máxima para um consumidor específico, em bytes.

Essa propriedade é herdada de __EventConsumer.

Nome

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: key

Nome exclusivo para esse consumidor.

Texto

Tipo de dados: string

Tipo de acesso: Somente leitura

Modelo de cadeia de caracteres padrão para o texto de uma entrada de log.

Comentários

Observação

O LogFileEventConsumer não protege o arquivo de log. Portanto, quando você configura o LogFileEventConsumer, é importante especificar um diretório protegido de acordo com o nível necessário.

A classe LogFileEventConsumer é derivada da classe abstrata __EventConsumer.

Exemplos

Para obter um exemplo de como usar LogFileEventConsumer para criar um consumidor, confia Gravar em um arquivo de log com base em um evento.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\subscription
MOF
Wbemcons.mof
DLL
Wbemcons.dll

Confira também

Classes de consumidor padrão

Gravar em um arquivo de log com base em um evento

Criar um consumidor lógico

Como receber eventos o tempo todo

__EventConsumer