Класс CommandLineEventConsumer

Класс CommandLineEventConsumer запускает произвольный процесс в локальной системе при доставке события. Этот класс является одним из стандартных потребителей событий, которые предоставляет WMI. Дополнительные сведения см. в статье Мониторинг и реагирование на события со стандартными потребителями.

Синтаксис

[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;
};

Члены

Класс CommandLineEventConsumer имеет следующие типы элементов:

• Свойства

Элемент Property

Класс CommandLineEventConsumer имеет следующие свойства.

CommandLineTemplate

Тип данных: string

Тип доступа: только для чтения

Стандартный шаблон строки, указывающий процесс, который необходимо запустить. Это свойство может иметь значение NULL, а свойство ExecutablePath используется в качестве командной строки.

CreateNewConsole

Тип данных: boolean

Тип доступа: только для чтения

Не используется. Если этому свойству присваивается значение, создается сообщение трассировки. Дополнительные сведения см. в разделе Трассировка действия WMI.

CreateNewProcessGroup

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, новый процесс является корневым процессом новой группы процессов. Группа процессов включает все процессы, которые являются потомками этого корневого процесса. Идентификатор процесса новой группы процессов совпадает с идентификатором этого процесса. Группы процессов используются методом GenerateConsoleCtrlEvent , чтобы разрешить отправку сигнала CTRL+C или CTRL+BREAK в группу консольных процессов.

CreateSeparateWowVdm

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, новый процесс выполняется на частной виртуальной машине DOS (VDM). Это допустимо только при запуске приложения, работающего в 16-разрядной операционной системе Windows. Если задано значение False, все приложения, работающие в 16-разрядной операционной системе Windows, запускаются как потоки в одном общем VDM. Дополнительные сведения см. в разделе Примечания этой статьи.

CreateSharedWowVdm

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, метод CreateProcess запускает новый процесс на общей виртуальной машине DOS (VDM). Это свойство может переопределить параметр DefaultSeparateVDM в разделе Windows Win.ini, если задано значение True. Дополнительные сведения см. в разделе Примечания этой статьи.

CreatorSID

Тип данных: массив uint8

Тип доступа: только для чтения

Идентификатор безопасности (SID), который однозначно идентифицирует пользователя, создающего фильтр. WMI хранит идентификатор безопасности пользователя, создающего экземпляр __EventConsumer , или идентификатор безопасности администратора в зависимости от операционной системы. Дополнительные сведения см. в разделах Привязка фильтра событий к логическому потребителю и Мониторинг и реагирование на события с помощью стандартных потребителей.

Это свойство наследуется от __EventConsumer.

DesktopName

Тип данных: string

Тип доступа: только для чтения

Не используется. Если этому свойству присвоено значение, создается сообщение трассировки. Дополнительные сведения см. в разделе Трассировка действия WMI.

Исполняемый путь

Тип данных: string

Тип доступа: только для чтения

Модуль для выполнения. В строке можно указать полный путь и имя файла модуля для выполнения или указать частичное имя. Если указано частичное имя, предполагается текущий диск и текущий каталог.

Свойство ExecutablePath может иметь значение NULL. В этом случае имя модуля должно быть первым маркером с разделителями пробелами в значении свойства CommandLineTemplate . Если используется длинное имя файла, содержащее пробел, используйте строки в кавычках, чтобы указать, где заканчивается имя файла, а аргументы начинают уточнять имя файла.

Примечание

Так как свойство CommandLineTemplate может быть шаблоном, в котором модуль для выполнения предоставляется переменной, свойство NullExecutablePath разрешает выполнение модуля, указанного в параметре , и затем выходит из вашего контроля. Всегда задайте свойство ExecutablePath в регистрации CommandLineEventConsumer , чтобы включить необходимый исполняемый файл, что позволяет избежать перезаписи параметрами событий. Если необходимо использовать шаблон и переменную, чтобы указать модуль для выполнения, будьте осторожны с тем, кому предоставлено полное право на запись в пространстве имен.

FillAttribute

Тип данных: uint32

Тип доступа: только для чтения

Указывает начальные цвета текста и фона, если в консольном приложении создается новое окно консоли.

FillAttributes

Тип данных: uint32

Тип доступа: чтение и запись

Исходные цвета текста и фона, если в консольном приложении создается новое окно консоли. Это свойство игнорируется в приложении графического пользовательского интерфейса. Значением может быть любое сочетание следующих значений.

1 (0x1)

синий передний план

2 (0x2)

зеленый передний план

4 (0x4)

красный передний план

8 (0x8)

интенсивность переднего плана

16 (0x10)

синий фон

32 (0x20)

зеленый фон

64 (0x40)

красный фон

128 (0x80)

интенсивность фона

Например, следующие сочетания создают красный текст на белом фоне:

0x4 | 0x40 | 0x20 | 0x10

или

0x74

Комментарии

Класс CommandLineEventConsumer является производным от абстрактного класса __EventConsumer .

Свойство CreateSeparateWowVdm указывает, выполняется ли новый процесс на частном виртуальном компьютере DOS (VDM). Преимущество запуска по отдельности заключается в том, что при сбое завершается только один VDM. Программы, работающие на разных виртуальных машинах, по-прежнему работают нормально, а 16-разрядные приложения windows, работающие в отдельных виртуальных машинах, имеют отдельные очереди ввода. Это означает, что если одно приложение перестает отвечать на запросы, приложения в отдельных виртуальных машинах продолжают получать входные данные. Недостаток запуска по отдельности заключается в том, что для этого требуется значительно больше памяти. Этому свойству следует присвоить значение True , только если пользователь запрашивает, чтобы 16-разрядные приложения windows запускались в собственном VDM.

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

Метод CreateProcess передает lpCommandLine как argv[0], argv[1]и т. д. Так как argv[0] для 16-разрядных приложений раньше зарезервировано имя исполняемого файла, предыдущий MOF-код приводит к созданию процесса, как если бы в командной строке была введена следующая команда: c:\windows\system32\cscript.exe param1 param2.

Предыдущая команда не выполняется, так как Cscript.exe не просматривает argv[0]и поэтому не распознает, что она содержит не собственное имя, а что-то другое ("c:\\scripts\\MyScript.js"). В следующем примере показано рекомендуемое использование CommandLineEventConsumer.

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

Предыдущее использование CommandLineEventConsumer приводит к созданию процесса, как если бы в командной строке была введена следующая команда: c:\windows\system32\cscript.exe c:\scripts\MyScript.js param1 param2

Так как теперь "c:\\scripts\\MyScript.js" имеет значение argv[1], оно отображается Cscript.exe и команда завершается успешно.

Дополнительные сведения см. в разделе Функция CreateProcess .

Примеры

Пример использования CommandLineEventConsumer для создания потребителя см. в разделе Запуск программы из командной строки на основе события.

Требования

См. также раздел

Стандартные классы потребителей

Мониторинг и реагирование на события с помощью стандартных потребителей

Создание логического потребителя

Получение событий в любое время

__EventConsumer