ServiceBase.OnCustomCommand(Int32) Metoda

Definicja

Po zaimplementowaniu w klasie pochodnej OnCustomCommand(Int32) wykonuje się, gdy Menedżer sterowania usługami przekazuje polecenie niestandardowe do usługi.When implemented in a derived class, OnCustomCommand(Int32) executes when the Service Control Manager (SCM) passes a custom command to the service. Określa akcje do wykonania, gdy występuje polecenie o określonej wartości parametru.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)

Parametry

command
Int32

Komunikat polecenia wysłany do usługi.The command message sent to the service.

Uwagi

OnCustomCommandumożliwia określenie dodatkowych funkcji poza uruchamianiem, zatrzymywaniem, wstrzymywaniem i kontynuowaniem usług.OnCustomCommand lets you specify additional functionality beyond starting, stopping, pausing and continuing services.

Menedżer SCM nie bada polecenia niestandardowego, aby sprawdzić, czy usługa obsługuje command przekazaną wartość parametru.The SCM does not examine the custom command to verify whether the service supports the command parameter passed in. Przekazuje polecenie niestandardowe bezpośrednio do usługi.It passes the custom command directly to the service. Jeśli usługa nie rozpoznaje command parametru, nic nie robi.If the service does not recognize the command parameter, it does nothing.

Polecenia niestandardowe są wywoływane przez ExecuteCommand instrukcję w ServiceController składniku.Custom commands are raised by an ExecuteCommand statement in a ServiceController component. Użyj instrukcji switch lub if.. następnie warunek obsługi niestandardowych poleceń zdefiniowanych w usłudze.Use a switch statement or if..then condition to handle the custom commands you define on your service.

Jedyne wartości dla polecenia niestandardowego, które można zdefiniować w aplikacji lub użyć w programie OnCustomCommand to między 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. Liczby całkowite poniżej 128 odpowiadają wartościom zarezerwowanym przez system.Integers below 128 correspond to system-reserved values.

Jeśli AutoLog Właściwość jest true , polecenia niestandardowe, podobnie jak wszystkie inne polecenia, zapisują wpisy w dzienniku zdarzeń, aby zgłosić, czy wykonywanie metody zakończyło się powodzeniem czy niepowodzeniem.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.

Dotyczy

Zobacz też