ServiceBase.OnCustomCommand(Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Po zaimplementowaniu w klasie OnCustomCommand(Int32) pochodnej program wykonuje polecenie , gdy program Service Control Manager (SCM) przekazuje do usługi polecenie niestandardowe. Określa akcje do wykonania, gdy występuje polecenie z określoną wartością 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
Komunikat polecenia wysłany do usługi.
Uwagi
OnCustomCommand Umożliwia określenie dodatkowych funkcji poza rozpoczęciem, zatrzymywaniem, wstrzymowaniem i kontynuowaniem usług.
Narzędzie SCM nie sprawdza polecenia niestandardowego, aby sprawdzić, czy usługa obsługuje command przekazany parametr. Przekazuje polecenie niestandardowe bezpośrednio do usługi. Jeśli usługa nie rozpoznaje parametru command , nic nie robi.
Polecenia niestandardowe są wywoływane przez instrukcję ExecuteCommand w składniku ServiceController . Użyj instrukcji switch lub if.. następnie warunek obsługi poleceń niestandardowych zdefiniowanych w usłudze.
Jedynymi wartościami polecenia niestandardowego, które można zdefiniować w aplikacji lub w programie , OnCustomCommand są wartości z zakresu od 128 do 255. Liczby całkowite poniżej 128 odpowiadają wartościom zarezerwowanym przez system.
AutoLog Jeśli właściwość to true, polecenia niestandardowe, takie jak wszystkie inne polecenia, zapisuj wpisy w dzienniku zdarzeń, aby zgłosić, czy wykonanie metody zakończyło się pomyślnie, czy nie powiodło się.