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 |
|
| DLL |
|