CommandLineEventConsumer, classe

La classe CommandLineEventConsumer démarre un processus arbitraire dans le système local quand un événement lui est remis. Cette classe est l’un des consommateurs d’événements standard fournis par WMI. Pour plus d’informations, consultez Monitoring des événements et réponse à ces derniers avec des consommateurs standard.

Syntaxe

[AMENDMENT]
class CommandLineEventConsumer : __EventConsumer
{
  uint8   CreatorSID[];
  string  MachineName;
  uint32  MaximumQueueSize;
  string  CommandLineTemplate;
  boolean CreateNewConsole = False;
  boolean CreateNewProcessGroup = True;
  boolean CreateSeparateWowVdm = False;
  boolean CreateSharedWowVdm = False;
  string  DesktopName;
  string  ExecutablePath;
  uint32  FillAttributes;
  boolean ForceOffFeedback = False;
  boolean ForceOnFeedback = False;
  uint32  KillTimeout = 0;
  string  Name;
  sint32  Priority = 0x20;
  boolean RunInteractively = False;
  uint32  ShowWindowCommand;
  boolean UseDefaultErrorMode = False;
  string  WindowTitle;
  string  WorkingDirectory;
  uint32  XCoordinate;
  uint32  XNumCharacters;
  uint32  XSize;
  uint32  YCoordinate;
  uint32  YNumCharacters;
  uint32  YSize;
  uint32  FillAttribute;
};

Membres

La classe CommandLineEventConsumer comporte les types de membre suivants :

• Propriétés

Propriétés

La classe CommandLineEventConsumer comporte les propriétés suivantes.

CommandLineTemplate

Type de données : chaîne

Type d'accès : Lecture seule

Modèle de chaîne standard qui spécifie le processus à démarrer. Cette propriété peut avoir une valeur NULL. La propriété ExecutablePath est utilisée en tant que ligne de commande.

CreateNewConsole

Type de données : booléen

Type d'accès : Lecture seule

Non utilisé. Si une valeur est affectée à cette propriété, un message de suivi est généré. Pour plus d’informations, consultez Suivi de l’activité WMI.

CreateNewProcessGroup

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est True, le nouveau processus est le processus racine d’un nouveau groupe de processus. Le groupe de processus comprend tous les processus descendants de ce processus racine. L’identificateur de processus du nouveau groupe de processus est identique à cet identificateur de processus. Les groupes de processus sont utilisés par la méthode GenerateConsoleCtrlEvent pour permettre l’envoi d’un signal Ctrl+C ou Ctrl+Pause à un groupe de processus de console.

CreateSeparateWowVdm

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est True, le nouveau processus s’exécute sur une VDM (machine virtuelle DOS) privée. Cela est valide uniquement au moment du démarrage d’une application s’exécutant sur un système d’exploitation Windows 16 bits. Si la valeur est False, toutes les applications s’exécutant sur un système d’exploitation Windows 16 bits s’exécutent en tant que threads dans une seul VDM partagée. Pour plus d’informations, consultez la section Remarques de cette rubrique.

CreateSharedWowVdm

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est True, la méthode CreateProcess exécute le nouveau processus dans la VDM (machine virtuelle DOS) partagée. Cette propriété peut remplacer le commutateur DefaultSeparateVDM dans la section Windows de Win.ini, si elle a la valeur True. Pour plus d’informations, consultez la section Remarques de cette rubrique.

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.

DesktopName

Type de données : chaîne

Type d'accès : Lecture seule

Non utilisé. Si une valeur est affectée à cette propriété, un message de suivi est généré. Pour plus d’informations, consultez Suivi de l’activité WMI.

ExecutablePath

Type de données : chaîne

Type d'accès : Lecture seule

Module à exécuter. La chaîne peut spécifier le chemin complet et le nom de fichier du module à exécuter, ou elle peut spécifier un nom partiel. Si un nom partiel est spécifié, le lecteur et le répertoire actifs sont utilisés par défaut.

La propriété ExecutablePath peut avoir une valeur NULL. Dans ce cas, le nom du module doit être le premier jeton délimité par des espaces blancs dans la valeur de la propriété CommandLineTemplate. Si vous spécifiez un nom de fichier long qui contient un espace, utilisez des chaînes entre guillemets pour indiquer la fin du nom de fichier et le début des arguments afin de clarifier le nom de fichier.

Notes

Dans la mesure où la propriété CommandLineTemplate peut être un modèle où le module à exécuter est fourni par une variable, une propriété ExecutablePath ayant une valeur NULL autorise le module spécifié dans le paramètre à s’exécuter, puis passe hors de votre contrôle. Définissez toujours la propriété ExecutablePath dans l’inscription de CommandLineEventConsumer pour inclure l’exécutable nécessaire, ce qui évite son remplacement par les paramètres d’événements. Si vous devez utiliser un modèle et une variable pour spécifier le module à exécuter, veillez à déterminer qui se voit octroyer le privilège d’écriture complet dans l’espace de noms.

FillAttribute

Type de données : uint32

Type d'accès : Lecture seule

Spécifie les couleurs initiales du texte et de l’arrière-plan si une fenêtre de console est créée dans une application console

FillAttributes

Type de données : uint32

Type d’accès : lecture/écriture

Couleurs initiales du texte et de l’arrière-plan, si une fenêtre de console est créée dans une application console. Cette propriété est ignorée dans une application GUI. La valeur peut correspondre à n’importe quelle combinaison des valeurs suivantes.

1 (0x1)

premier plan bleu

2 (0x2)

premier plan vert

4 (0x4)

premier plan rouge

8 (0x8)

intensité du premier plan

16 (0x10)

arrière-plan bleu

32 (0x20)

arrière-plan vert

64 (0x40)

arrière-plan rouge

128 (0x80)

intensité de l’arrière-plan

Par exemple, les combinaisons suivantes produisent du texte en rouge sur un arrière-plan blanc :

0x4 | 0x40 | 0x20 | 0x10

ou

0x74

Notes

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

La propriété CreateSeparateWowVdm indique si le nouveau processus s’exécute ou non dans une VDM (machine virtuelle DOS) privée. Dans le cas d’une exécution séparée, tout plantage entraîne uniquement l’arrêt de la VDM, ce qui représente un avantage. Les programmes s’exécutant dans des VDM distinctes continuent de fonctionner normalement. De plus, les applications Windows 16 bits s’exécutant dans des VDM distinctes ont des files d’attente d’entrée distinctes. Cela signifie que si une application cesse de répondre momentanément, les applications situées dans des VDM distinctes continuent de recevoir des entrées. L’inconvénient d’une exécution séparée est qu’elle utilise beaucoup plus de mémoire. Vous devez affecter la valeur True à cette propriété uniquement si l’utilisateur souhaite que les applications Windows 16 bits s’exécutent dans leur propre VDM.

instance of CommandLineEventConsumer
{
  ExecutablePath = "C:\\windows\\system32\\cscript.exe";
  CommandLineTemplate = "C:\\scripts\\MyScript.js param1 param2";
};

La méthode CreateProcess passe lpCommandLine en tant que argv[0], argv[1], etc. Dans la mesure où argv[0] pour les applications 16 bits était réservé au nom de fichier exécutable, le code MOF précédent entraîne la création du processus, comme si la commande suivante était entrée à l’invite de commandes : c:\windows\system32\cscript.exe param1 param2.

La commande précédente n’aboutit pas, car Cscript.exe ne voit pas argv[0]. Il ne peut donc pas détecter qu’il ne contient pas son propre nom, mais quelque chose d’autre (« c:\\scripts\\MyScript.js »). L’exemple suivant identifie l’utilisation recommandée de CommandLineEventConsumer.

instance of CommandLineEventConsumer
{
  ExecutablePath = "C:\\windows\\system32\\cscript.exe";
  CommandLineTemplate = "C:\\windows\\system32\\cscript.exe"
    "C:\\scripts\\MyScript.js param1 param2";
};

L’utilisation précédente de CommandLineEventConsumer entraîne la création du processus, comme si la commande suivante était entrée à l’invite de commandes : c:\windows\system32\cscript.exe c:\scripts\MyScript.js param1 param2

Dans la mesure où « c :\\scripts\\MyScript.js » a désormais la valeur argv[1], il est vu par Cscript.exe et la commande réussit.

Pour plus d’informations, consultez la fonction CreateProcess.

Exemples

Pour obtenir un exemple d’utilisation de CommandLineEventConsumer afin de créer un consommateur, consultez Exécution d’un programme à partir de la ligne de commande en fonction d’un événement.

Spécifications

Voir aussi

Classes de consommateur standard

Monitoring des événements et réponse à ces derniers avec des consommateurs standard

Création d’un consommateur logique

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

__EventConsumer