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í.
Když je implementovaná v odvozené třídě, OnCustomCommand(Int32) spustí se, když Správce řízení služeb (SCM) předá službě 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 -> unitProtected 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 spouštění, zastavování, pozastavení a pokračování služeb.
SCM neprověřuje vlastní příkaz a ověří, jestli služba podporuje command předaný 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 službě.
Jediné hodnoty pro vlastní příkaz, který můžete definovat v aplikaci nebo použít OnCustomCommand , jsou hodnoty v rozmezí 128 až 255. Celá čísla nižší než 128 odpovídají hodnotám rezervovaným systémem.
AutoLog Pokud je truevlastnost , vlastní příkazy, stejně jako všechny ostatní příkazy, zapisují položky do protokolu událostí, aby hlásily, zda provádění metody proběhlo úspěšně nebo selhalo.