ServiceBase.OnStop ServiceBase.OnStop ServiceBase.OnStop ServiceBase.OnStop Method

Definition

Wird bei der Implementierung in einer abgeleiteten Klasse ausgeführt, wenn der Dienststeuerungs-Manager einen Befehl zum Beenden an den Dienst sendet.When implemented in a derived class, executes when a Stop command is sent to the service by the Service Control Manager (SCM). Gibt Aktionen an, die beim Beenden eines Diensts auszuführen sind.Specifies actions to take when a service stops running.

protected:
 virtual void OnStop();
protected virtual void OnStop ();
abstract member OnStop : unit -> unit
override this.OnStop : unit -> unit
Protected Overridable Sub OnStop ()

Hinweise

Verwenden OnStop Sie, um die Verarbeitung anzugeben, die auftritt, wenn der Dienst einen Befehl zum Beenden empfängt.Use OnStop to specify the processing that occurs when the service receives a Stop command.

Wenn der SCM einen Befehl zum Beenden empfängt, verwendet er den Wert CanStop von, um zu überprüfen, ob der Dienst Befehle zum Beenden akzeptiert.When the SCM receives a Stop command, it uses the value of CanStop to verify whether the service accepts Stop commands. Wenn CanStopden Wert OnStop hat, wird der Befehl zum Abbrechen an den Dienst übermittelt, und die-Methode wird aufgerufen, wenn Sie definiert ist. trueIf CanStop is true, the Stop command is passed to the service, and the OnStop method is called if it is defined. Wenn OnStop im Dienst nicht implementiert ist, verarbeitet der SCM den Befehl zum Abbrechen.If OnStop is not implemented in the service, the SCM handles the Stop command.

Wenn CanStopden Wert hat,ignoriertderSCMdenBefehlzumAbbrechen.falseIf CanStop is false, the SCM ignores the Stop command. Sie wird nicht an den Dienst übermittelt.It is not passed to the service. Der Befehl "beenden" gibt zurück und löst eine Ausnahme aus.The Stop command returns and throws an exception.

OnStopEs wird erwartet, dass in der abgeleiteten Klasse überschrieben wird.OnStop is expected to be overridden in the derived class. Damit der Dienst nützlich ist, OnStart sollten und OnStop in ihrer Dienstklasse implementiert werden.For the service to be useful, OnStart and OnStop should both be implemented in your service class.

Gilt für:

Siehe auch