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