ServiceController.Status Właściwość

Definicja

Przestrzeń nazw:

System.ServiceProcess

Zestaw:

System.ServiceProcess.ServiceController.dll

Pakiet:

System.ServiceProcess.ServiceController v9.0.0-rc.2.24473.5

Źródło:

ServiceController.cs

Pobiera stan usługi, do którego odwołuje się to wystąpienie.

public:
 property System::ServiceProcess::ServiceControllerStatus Status { System::ServiceProcess::ServiceControllerStatus get(); };

public System.ServiceProcess.ServiceControllerStatus Status { get; }

member this.Status : System.ServiceProcess.ServiceControllerStatus

Public ReadOnly Property Status As ServiceControllerStatus

Wartość właściwości

ServiceControllerStatus

ServiceControllerStatus Jedną z wartości wskazujących, czy usługa jest uruchomiona, zatrzymana lub wstrzymana, czy też oczekujące polecenie uruchamiania, zatrzymywania, wstrzymania lub kontynuowania.

Wyjątki

Win32Exception

Wystąpił błąd podczas uzyskiwania dostępu do interfejsu API systemu.

InvalidOperationException

Nie można odnaleźć usługi.

Przykłady

W poniższym przykładzie użyto klasy do ServiceController sprawdzenia bieżącego stanu usługi Telnet. Jeśli usługa zostanie zatrzymana, przykład uruchomi usługę. Jeśli usługa jest uruchomiona, przykład zatrzymuje usługę.

// Toggle the Telnet service - 
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController^ sc = gcnew ServiceController(  "Telnet" );
if ( sc )
{
   Console::WriteLine(  "The Telnet service status is currently set to {0}", sc->Status );
   if ( (sc->Status == (ServiceControllerStatus::Stopped) ) || (sc->Status == (ServiceControllerStatus::StopPending) ) )
   {
      // Start the service if the current status is stopped.
      Console::WriteLine(  "Starting the Telnet service..." );
      sc->Start();
   }
   else
   {
      // Stop the service if its status is not set to "Stopped".
      Console::WriteLine(  "Stopping the Telnet service..." );
      sc->Stop();
   }

   // Refresh and display the current service status.
   sc->Refresh();
   Console::WriteLine(  "The Telnet service status is now set to {0}.", sc->Status );

// Toggle the Telnet service -
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController sc = new ServiceController("Telnet");
Console.WriteLine("The Telnet service status is currently set to {0}",
                  sc.Status);

if ((sc.Status == ServiceControllerStatus.Stopped) ||
    (sc.Status == ServiceControllerStatus.StopPending))
{
   // Start the service if the current status is stopped.

   Console.WriteLine("Starting the Telnet service...");
   sc.Start();
}
else
{
   // Stop the service if its status is not set to "Stopped".

   Console.WriteLine("Stopping the Telnet service...");
   sc.Stop();
}

// Refresh and display the current service status.
sc.Refresh();
Console.WriteLine("The Telnet service status is now set to {0}.",
                   sc.Status);

' Toggle the Telnet service - 
' If it is started (running, paused, etc), stop the service.
' If it is stopped, start the service.
Dim sc As New ServiceController("Telnet")
Console.WriteLine("The Telnet service status is currently set to {0}", sc.Status)

If sc.Status.Equals(ServiceControllerStatus.Stopped) Or sc.Status.Equals(ServiceControllerStatus.StopPending) Then
   ' Start the service if the current status is stopped.
   Console.WriteLine("Starting the Telnet service...")
   sc.Start()
Else
   ' Stop the service if its status is not set to "Stopped".
   Console.WriteLine("Stopping the Telnet service...")
   sc.Stop()
End If

' Refresh and display the current service status.
sc.Refresh()
Console.WriteLine("The Telnet service status is now set to {0}.", sc.Status)

Uwagi

Stan wskazuje bieżący stan usługi. Zestaw możliwych wartości zawiera kilka, które wskazują, czy oczekujące polecenie zmiany stanu.