ServiceBase.OnCustomCommand(Int32) ServiceBase.OnCustomCommand(Int32) ServiceBase.OnCustomCommand(Int32) ServiceBase.OnCustomCommand(Int32) Method

Definizione

Quando viene eseguita l'implementazione in una classe derivata, l'esecuzione di OnCustomCommand(Int32) avviene quando Gestione controllo servizi passa al servizio un comando personalizzato.When implemented in a derived class, OnCustomCommand(Int32) executes when the Service Control Manager (SCM) passes a custom command to the service. Specifica le azioni da intraprendere quando ricorre un comando con il parametro specificato.Specifies actions to take when a command with the specified parameter value occurs.

protected:
 virtual void OnCustomCommand(int command);
protected virtual void OnCustomCommand (int command);
abstract member OnCustomCommand : int -> unit
override this.OnCustomCommand : int -> unit
Protected Overridable Sub OnCustomCommand (command As Integer)

Parametri

command
Int32 Int32 Int32 Int32

Messaggio di comando inviato al servizio.The command message sent to the service.

Commenti

OnCustomCommand è possibile specificare funzionalità aggiuntive rispetto all'avvio, arresto, sospensione e continuazione dei servizi.OnCustomCommand lets you specify additional functionality beyond starting, stopping, pausing and continuing services.

Gestione controllo servizi non esamina il comando personalizzato per verificare se il servizio supporta il command parametro passato.The SCM does not examine the custom command to verify whether the service supports the command parameter passed in. Il comando personalizzato passa direttamente al servizio.It passes the custom command directly to the service. Se il servizio non riconosce il command parametro, non esegue alcuna operazione.If the service does not recognize the command parameter, it does nothing.

Comandi personalizzati vengono generati da un ExecuteCommand istruzione in un ServiceController componente.Custom commands are raised by an ExecuteCommand statement in a ServiceController component. Usare un'istruzione switch o if... Then per gestire i comandi personalizzati definiti nel servizio.Use a switch statement or if..then condition to handle the custom commands you define on your service.

Gli unici valori validi per un comando personalizzato che è possibile definire all'interno dell'applicazione o usare in OnCustomCommand sono quelle da 128 a 255.The only values for a custom command that you can define in your application or use in OnCustomCommand are those between 128 and 255. Numeri interi inferiori a 128 corrispondono ai valori riservati di sistema.Integers below 128 correspond to system-reserved values.

Se il AutoLog è di proprietà true, comandi personalizzati, analogamente a tutti gli altri comandi, scriveranno voci nel registro eventi per segnalare se l'esecuzione del metodo ha avuto esito positivo o negativo.If the AutoLog property is true, custom commands, like all other commands, write entries to the event log to report whether the method execution succeeded or failed.

Si applica a

Vedi anche