ServiceController.CanStop Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a value indicating whether the service can be stopped after it has started.

Namespace:   System.ServiceProcess
Assembly:  System.ServiceProcess (in System.ServiceProcess.dll)

<ServiceProcessDescriptionAttribute("SPCanStop")>
Public ReadOnly Property CanStop As Boolean

Property Value

Type: System.Boolean

true if the service can be stopped and the OnStop method called; otherwise, false.

Exception Condition
Win32Exception

An error occurred when accessing a system API.

InvalidOperationException

The service was not found.

The following example demonstrates the use of the CanStop property to determine whether a service provides a handler for a stop event. This example is part of a larger example that is provided for the ServiceController class.

' Display properties for the Simple Service sample 
' from the ServiceBase example
Dim sc As New ServiceController("Simple Service")
Console.WriteLine("Status = " + sc.Status.ToString())
Console.WriteLine("Can Pause and Continue = " + _
    sc.CanPauseAndContinue.ToString())
Console.WriteLine("Can ShutDown = " + sc.CanShutdown.ToString())
Console.WriteLine("Can Stop = " + sc.CanStop.ToString())

.NET Framework
Available since 1.1
Return to top
Show: