ServiceBase.OnCustomCommand(Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ausgeführt, OnCustomCommand(Int32) wenn der Dienststeuerungs-Manager (Service Control Manager, SCM) einen benutzerdefinierten Befehl an den Dienst übergibt. Gibt Aktionen an, die ausgeführt werden sollen, wenn ein Befehl mit dem angegebenen Parameterwert auftritt.
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)Parameter
- command
- Int32
Die an den Dienst gesendete Befehlsnachricht.
Hinweise
OnCustomCommand ermöglicht es Ihnen, zusätzliche Funktionen anzugeben, die über das Starten, Beenden, Anhalten und Fortsetzen von Diensten hinausgehen.
Der SCM überprüft nicht den benutzerdefinierten Befehl, um zu überprüfen, ob der Dienst den command übergebenen Parameter unterstützt. Er übergibt den benutzerdefinierten Befehl direkt an den Dienst. Wenn der Dienst den command Parameter nicht erkennt, führt er nichts aus.
Benutzerdefinierte Befehle werden von einer ExecuteCommand Anweisung in einer ServiceController Komponente ausgelöst. Verwenden Sie eine Switch-Anweisung oder if.. dann die Bedingung, um die benutzerdefinierten Befehle zu behandeln, die Sie für Ihren Dienst definieren.
Die einzigen Werte für einen benutzerdefinierten Befehl, den Sie in Ihrer Anwendung definieren oder verwenden OnCustomCommand können, sind die Werte zwischen 128 und 255. Ganze Zahlen unter 128 entsprechen systemgeschützten Werten.
Wenn es sich bei der AutoLog Eigenschaft trueum benutzerdefinierte Befehle wie alle anderen Befehle handelt, schreiben Sie Einträge in das Ereignisprotokoll, um zu melden, ob die Methodenausführung erfolgreich war oder fehlgeschlagen ist.
