LogFileEventConsumer (clase)

La clase LogFileEventConsumer escribe cadenas personalizadas en un archivo de registro de texto cuando se le entregan eventos. Las cadenas están separadas por secuencias de fin de línea. Esta clase es uno de los consumidores de eventos estándar que proporciona WMI. Para más información, vea Supervisión y respuesta a eventos con consumidores estándar.

Sintaxis

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

Miembros

La clase LogFileEventConsumer tiene estos tipos de miembros:

• Propiedades

Propiedades

La clase LogFileEventConsumer tiene estas propiedades.

CreatorSID

Tipo de datos: matriz uint8

Tipo de acceso: solo lectura

Id. de seguridad (SID) que identifica de forma única al usuario que crea un filtro. WMI almacena el SID del usuario que crea una instancia de __EventConsumer o el SID de administrador, en función del sistema operativo. Para más información, consulte Enlace de un filtro de eventos con un consumidor lógico y Supervisión y respuesta a eventos con consumidores estándar.

Esta propiedad se hereda de __EventConsumer.

Nombre de archivo

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre de un archivo que incluye la ruta de acceso a la que se anexan las entradas del Registro. Si el archivo no existe, LogFileEventConsumer intenta crearlo. Se produce un error en el consumidor cuando la ruta de acceso no existe o cuando el usuario que crea el consumidor no tiene permisos de escritura para el archivo o la ruta de acceso.

IsUnicode

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es TRUE, el archivo de registro es un archivo de texto Unicode. Si es FALSE, el archivo de registro es un archivo de texto de código multibyte. Si el archivo existe, esta propiedad se omite y se usa la configuración del archivo actual. Por ejemplo, si IsUnicode es FALSE, pero el archivo existente es un archivo Unicode, se usa Unicode. Si IsUnicode es TRUE, pero el archivo es código multibyte, se usa el código multibyte.

MachineName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre del equipo al que Instrumental de administración de Windows (WMI) envía eventos.

Esta propiedad se hereda de __EventConsumer.

MaximumFileSize

Tipo de datos: uint64

Tipo de acceso: solo lectura

Tamaño máximo de un archivo de registro en bytes. Si el archivo principal supera su tamaño máximo, el contenido se mueve a otro archivo y se vacía el archivo principal. Un valor de 0 (cero) significa que no hay límite de tamaño. El valor predeterminado es de 65 535 bytes. El tamaño del archivo se comprueba antes de una operación de escritura. Por tanto, puede tener un archivo que sea ligeramente mayor que el límite de tamaño especificado. La siguiente operación de escritura lo detecta e inicia un nuevo archivo.

En la lista siguiente se identifica la estructura de nomenclatura del archivo de copia de seguridad:

• Si el nombre de archivo original es 8.3, la extensión se reemplaza por una cadena con el formato "001", "002", etc., por el número más pequeño que todos los números usados y elegidos anteriormente. Si se usa "999", el número elegido es el número más pequeño sin usar.
• Si el nombre de archivo original no es 8.3, se anexa una cadena con el formato "001", "002", etc., al nombre de archivo.

Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.

MaximumQueueSize

Tipo de datos: uint32

Tipo de acceso: solo lectura

Cola máxima para un consumidor específico, en bytes.

Esta propiedad se hereda de __EventConsumer.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: key

Nombre único para este consumidor.

Texto

Tipo de datos: cadena

Tipo de acceso: solo lectura

Plantilla de cadena estándar para el texto de una entrada de registro.

Comentarios

Nota

LogFileEventConsumer no protege el archivo de registro. Por tanto, al configurar LogFileEventConsumer, es importante especificar un directorio protegido en el nivel que necesite.

La clase LogFileEventConsumer se deriva de la clase abstracta __EventConsumer.

Ejemplos

Para obtener un ejemplo del uso de LogFileEventConsumer a fin de crear un consumidor, vea Escritura en un archivo de registro en función de un evento.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\subscription
MOF	Wbemcons.mof
Archivo DLL	Wbemcons.dll

Consulte también

Clases de consumidor estándar

Escritura en un archivo de registro en función de un evento

Creación de un consumidor lógico

Recepción de eventos en todo momento

__EventConsumer