ServiceBase.OnStop Methode

Definition

Wird bei der Implementierung in einer abgeleiteten Klasse ausgeführt, wenn der Dienststeuerungs-Manager einen Befehl zum Beenden an den Dienst sendet. Gibt Aktionen an, die beim Beenden eines Diensts auszuführen sind.

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

Hinweise

Verwenden Sie OnStop , um die Verarbeitung anzugeben, die erfolgt, wenn der Dienst einen Stop-Befehl empfängt.

Wenn der SCM einen Stop-Befehl empfängt, wird der Wert von CanStop verwendet, um zu überprüfen, ob der Dienst Stoppbefehle akzeptiert. Wenn CanStop ist true, wird der Stop-Befehl an den Dienst übergeben, und die OnStop -Methode wird aufgerufen, wenn sie definiert ist. Wenn OnStop nicht im Dienst implementiert ist, verarbeitet der SCM den Befehl Beenden.

Wenn CanStop dies der Wert ist false, ignoriert der SCM den Befehl Beenden. Sie wird nicht an den Dienst übergeben. Der Befehl Stop gibt zurück und löst eine Ausnahme aus.

OnStop wird erwartet, dass sie in der abgeleiteten Klasse überschrieben wird. Damit der Dienst nützlich ist und OnStartOnStop beide in Ihrer Dienstklasse implementiert werden sollten.

Gilt für:

Weitere Informationen