ServiceBase.OnCustomCommand(Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Při implementaci v odvozené třídě se spustí, OnCustomCommand(Int32) když Správce řízení služeb (SCM) předá do služby vlastní příkaz. Určuje akce, které se mají provést, když dojde k příkazu se zadanou hodnotou parametru.
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
Zpráva příkazu poslaná do služby.
Poznámky
OnCustomCommand umožňuje určit další funkce nad rámec spuštění, zastavení, pozastavení a pokračování služeb.
SCM nekontroluje vlastní příkaz, aby ověřil, jestli služba podporuje předaný command parametr. Předá vlastní příkaz přímo službě. Pokud služba parametr nerozpozná command , nic nedělá.
Vlastní příkazy jsou vyvolány příkazem ExecuteCommand v komponentě ServiceController . Použijte příkaz switch nebo if.. pak podmínka pro zpracování vlastních příkazů, které definujete ve vaší službě.
Jedinými hodnotami pro vlastní příkaz, který můžete definovat v aplikaci nebo použít OnCustomCommand , jsou hodnoty od 128 do 255. Celá čísla nižší než 128 odpovídají systémovým hodnotám vyhrazeným pro systém.
AutoLog Pokud je truetato vlastnost , vlastní příkazy, stejně jako všechny ostatní příkazy, zapisují položky do protokolu událostí a hlásí, zda bylo spuštění metody úspěšné nebo neúspěšné.