Classe CommandLineEventConsumer

La classe CommandLineEventConsumer avvia un processo arbitrario nel sistema locale quando viene recapitato un evento. Questa classe è uno dei consumer di eventi standard forniti da WMI. Per altre informazioni, vedere Monitoraggio e risposta agli eventi con consumer standard.

Sintassi

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

Members

La classe CommandLineEventConsumer include questi tipi di membri:

• Proprietà

Proprietà

La classe CommandLineEventConsumer ha queste proprietà.

CommandLineTemplate

Tipo di dati: stringa

Tipo di accesso: sola lettura

Modello stringa standard che specifica il processo da avviare. Questa proprietà può essere NULL e la proprietà EseguibilPath viene usata come riga di comando.

CreateNewConsole

Tipo di dati: booleano

Tipo di accesso: sola lettura

Non usato. Se viene assegnato un valore a questa proprietà, viene generato un messaggio di traccia. Per altre informazioni, vedere Traccia attività WMI.

CreateNewProcessGroup

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, il nuovo processo è il processo radice di un nuovo gruppo di processi. Il gruppo di processi include tutti i processi discendenti di questo processo radice. L'identificatore del processo del nuovo gruppo di processi è lo stesso di questo identificatore di processo. I gruppi di processi vengono usati dal metodo GenerateConsoleCtrlEvent per abilitare l'invio di un segnale CTRL+C o CTRL+BREAK a un gruppo di processi della console.

CreateSeparateWowVdm

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, il nuovo processo viene eseguito in una macchina virtuale privata (VDM). Questa operazione è valida solo quando si avvia un'applicazione in esecuzione in un sistema operativo Windows a 16 bit. Se impostato su False, tutte le applicazioni in esecuzione in un sistema operativo Windows a 16 bit vengono eseguite come thread in un singolo VDM condiviso. Per altre informazioni, vedere la sezione Osservazioni di questo argomento.

CreateSharedWowVdm

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, il metodo CreateProcess esegue il nuovo processo nella macchina virtuale condivisa (VDM). Questa proprietà può eseguire l'override dell'opzione DefaultSeparateVDM nella sezione Windows di Win.ini se impostata su True. Per altre informazioni, vedere la sezione Osservazioni di questo argomento.

CreatorSID

Tipo di dati: matrice uint8

Tipo di accesso: sola lettura

Identificatore di sicurezza (SID) che identifica in modo univoco l'utente che crea un filtro. WMI archivia il SID dell'utente che crea un'istanza di __EventConsumer o il SID amministratore, a seconda del sistema operativo. Per altre informazioni, vedere Associazione di un filtro eventi con un consumer logico e monitoraggio e risposta agli eventi con consumer standard.

Questa proprietà viene ereditata da __EventConsumer.

DesktopName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Non usato. Se viene assegnato un valore a questa proprietà viene generato un messaggio di traccia. Per altre informazioni, vedere Traccia attività WMI.

ExecutablePath

Tipo di dati: stringa

Tipo di accesso: sola lettura

Modulo da eseguire. La stringa può specificare il percorso completo e il nome del file del modulo da eseguire oppure può specificare un nome parziale. Se viene specificato un nome parziale, si presuppone che l'unità corrente e la directory corrente.

La proprietà EseguibilPath può essere NULL. In tal caso, il nome del modulo deve essere il primo token delimitato da spazi vuoti nel valore della proprietà CommandLineTemplate . Se si usa un nome file lungo contenente uno spazio, usare stringhe con virgolette per indicare dove termina il nome del file e gli argomenti iniziano a chiarire il nome del file.

Nota

Poiché la proprietà CommandLineTemplate può essere un modello in cui il modulo da eseguire viene fornito da una variabile, una proprietà eseguibileNULL consente al modulo specificato nel parametro di eseguire e quindi è fuori dal controllo. Impostare sempre la proprietà EseguibilPath nella registrazione CommandLineEventConsumer per includere il file eseguibile richiesto, che evita la sovrascrittura in base ai parametri degli eventi. Se è necessario usare un modello e una variabile per specificare il modulo da eseguire, prestare attenzione a chi ha concesso privilegi di scrittura completi nello spazio dei nomi.

FillAttribute

Tipo di dati: uint32

Tipo di accesso: sola lettura

Specifica i colori iniziali di testo e sfondo se viene creata una nuova finestra della console in un'applicazione console

FillAttributes

Tipo di dati: uint32

Tipo di accesso: Lettura/scrittura

Testo iniziale e colori di sfondo, se viene creata una nuova finestra della console in un'applicazione console. Questa proprietà viene ignorata in un'applicazione GUI. Il valore può essere qualsiasi combinazione dei valori seguenti.

1 (0x1)

primo piano blu

2 (0x2)

primo piano verde

4 (0x4)

primo piano rosso

8 (0x8)

intensità in primo piano

16 (0x10)

sfondo blu

32 (0x20)

sfondo verde

64 (0x40)

sfondo rosso

128 (0x80)

intensità di sfondo

Ad esempio, le combinazioni seguenti producono testo rosso in uno sfondo bianco:

0x4 | 0x40 | 0x20 | 0x10

oppure

0x74

Commenti

La classe CommandLineEventConsumer deriva dalla classe astratta __EventConsumer .

La proprietà CreateSeparateWowVdm indica se il nuovo processo viene eseguito in una macchina virtuale privata (VDM). Il vantaggio di eseguire separatamente è che un arresto anomalo termina solo il singolo VDM. I programmi in esecuzione in macchine virtuali distinte continuano a funzionare normalmente e le applicazioni basate su Windows a 16 bit in esecuzione in macchine virtuali separate hanno code di input separate. Ciò significa che se un'applicazione smette di rispondere momentaneamente, le applicazioni in macchine virtuali separate continuano a ricevere input. Lo svantaggio dell'esecuzione separata consiste nel fatto che richiede molto più memoria per farlo. È consigliabile impostare questa proprietà su True solo se l'utente richiede che le applicazioni basate su Windows a 16 bit vengano eseguite nel proprio VDM.

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

Il metodo CreateProcess passa lpCommandLine come argv[0], argv[1]e così via. Poiché argv[0] per le applicazioni a 16 bit usate per essere riservate per il nome del file eseguibile, il codice MOF precedente comporta la creazione del processo come se il comando seguente venga immesso al prompt dei comandi: c:\windows\system32\cscript.exe param1 param2.

Il comando precedente non riesce perché Cscript.exe non esamina argv[0]e quindi non riconosce che non contiene il proprio nome, ma qualcos'altro ("c:\\scripts\\MyScript.js"). Nell'esempio seguente viene identificato l'uso consigliato di CommandLineEventConsumer.

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

L'uso precedente di CommandLineEventConsumer comporta la creazione del processo come se fosse stato immesso il comando seguente al prompt dei comandi: c:\windows\system32\cscript.exe c:\scripts\MyScript.js param1 param2

Poiché "c:\\scripts\\MyScript.js" è ora argv[1], viene visualizzato da Cscript.exe e il comando ha esito positivo.

Per altre informazioni, vedere la funzione CreateProcess .

Esempio

Per un esempio di utilizzo di CommandLineEventConsumer per creare un consumer, vedere Esecuzione di un programma dalla riga di comando in base a un evento.

Requisiti

Vedi anche

Classi consumer standard

Monitoraggio e risposta agli eventi con consumer standard

Creazione di un consumer logico

Ricezione di eventi in qualsiasi momento

__EventConsumer