Classe LogFileEventConsumer

La classe LogFileEventConsumer écrit des chaînes personnalisées dans un fichier journal texte lorsque des événements lui sont remis. Les chaînes sont séparées par des séquences de fin de ligne. Cette classe est l’un des consommateurs d’événements standard que WMI fournit. Pour plus d’informations, voir Surveillance et réponse aux événements avec des consommateurs standard.

Syntaxe

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

Membres

La classe LogFileEventConsumer possède ces types de membres :

• Propriétés

Propriétés

La classe LogFileEventConsumer possède les propriétés suivantes.

CreatorSID

Type de données : tableau uint8

Type d'accès : Lecture seule

Identificateur de sécurité (SID) qui identifie de manière unique l’utilisateur qui crée un filtre. WMI stocke le SID de l’utilisateur qui crée une instance de __EventConsumer ou le SID de l’administrateur, en fonction du système d’exploitation. Pour plus d’informations, consultez Liaison d’un filtre d’événement à un consommateur logique et Monitoring des événements et réponse à ces derniers avec des consommateurs standard.

Cette propriété est héritée de __EventConsumer.

Nom du fichier

Type de données : chaîne

Type d'accès : Lecture seule

Nom d’un fichier qui inclut le chemin d’accès auquel les entrées de journal sont ajoutées. Si le fichier n'existe pas, LogFileEventConsumer tente de le créer. Le consommateur échoue lorsque le chemin d’accès n’existe pas, ou lorsque l’utilisateur qui crée le consommateur ne dispose pas des autorisations d’écriture pour le fichier ou le chemin d’accès.

IsUnicode

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est TRUE, le fichier journal est un fichier texte Unicode. Si la valeur est FALSE, le fichier journal est un fichier texte de code multioctet. Si le fichier existe, cette propriété est ignorée et le paramètre de fichier actuel est utilisé. Par exemple, si IsUnicode est FALSE, mais que le fichier existant est un fichier Unicode, Unicode est utilisé. Si IsUnicode est TRUE, mais que le fichier est du code multioctet, le code multioctet est utilisé.

MachineName

Type de données : chaîne

Type d'accès : Lecture seule

Nom de l’ordinateur auquel WMI (Windows Management Instrumentation) envoie les événements.

Cette propriété est héritée de __EventConsumer.

MaximumFileSize

Type de données : uint64

Type d'accès : Lecture seule

Taille maximale du fichier journal, en octets. Si le fichier principal dépasse sa taille maximale, le contenu est déplacé vers un autre fichier et le fichier principal est vidé. Une valeur de 0 (zéro) signifie qu'il n'y a pas de limite de taille. La valeur par défaut est 65,535 octets. La taille du fichier est vérifiée avant une opération d’écriture. Par conséquent, vous pouvez avoir un fichier légèrement supérieur à la limite de taille spécifiée. L’opération d’écriture suivante l’intercepte et démarre un nouveau fichier.

La liste suivante identifie la structure de dénomination du fichier de sauvegarde :

• Si le nom de fichier d’origine est 8.3, l’extension est remplacée par une chaîne au format « 001 », « 002 », et ainsi de suite avec le plus petit nombre supérieur à tous les nombres précédemment utilisés et choisis. Si « 999 » est utilisé, le nombre choisi est le plus petit nombre inutilisé.
• Si le nom de fichier d’origine n’est pas 8.3, une chaîne au format « 001 », « 002 », etc. est ajoutée au nom de fichier.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

MaximumQueueSize

Type de données : uint32

Type d'accès : Lecture seule

File d’attente maximale pour un consommateur spécifique, en octets.

Cette propriété est héritée de __EventConsumer.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

Nom unique de ce consommateur.

Texte

Type de données : chaîne

Type d'accès : Lecture seule

Modèle de chaîne standard pour le texte d'une entrée de journal.

Notes

La classe LogFileEventConsumer est dérivée de la classe abstraite __EventConsumer.

Exemples

Pour obtenir un exemple d’utilisation de LogFileEventConsumer pour créer un consommateur, consultez Écriture dans un fichier journal basé sur un événement.

Spécifications

Voir aussi

Classes consommateur standard

Écriture dans un fichier journal basé sur un événement

Création d’un consommateur logique

Réception d’événements à tout moment

__EventConsumer