ServiceController.ServicesDependedOn Property

Reference

Definition

Namespace:: System.ServiceProcess

Assembly:: System.ServiceProcess.ServiceController.dll

Assembly:: System.ServiceProcess.dll

Package:: System.ServiceProcess.ServiceController v10.0.0-preview.1.25080.5

Source:: ServiceController.cs

Source:: ServiceController.cs

Source:: ServiceController.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The set of services that this service depends on.

public:
 property cli::array <System::ServiceProcess::ServiceController ^> ^ ServicesDependedOn { cli::array <System::ServiceProcess::ServiceController ^> ^ get(); };

public System.ServiceProcess.ServiceController[] ServicesDependedOn { get; }

[System.ServiceProcess.ServiceProcessDescription("SPServicesDependedOn")]
public System.ServiceProcess.ServiceController[] ServicesDependedOn { get; }

member this.ServicesDependedOn : System.ServiceProcess.ServiceController[]

[<System.ServiceProcess.ServiceProcessDescription("SPServicesDependedOn")>]
member this.ServicesDependedOn : System.ServiceProcess.ServiceController[]

Public ReadOnly Property ServicesDependedOn As ServiceController()

Property Value

ServiceController[]

An array of ServiceController instances, each of which is associated with a service that must be running for this service to run.

Attributes: ServiceProcessDescriptionAttribute

Exceptions

Win32Exception

An error occurred when accessing a system API.

InvalidOperationException

The service was not found.

Examples

The following example uses the ServiceController class to display the set of services that the Messenger service is dependent on.

ServiceController^ sc = gcnew ServiceController(  "Messenger" );
array<ServiceController^>^scServices = nullptr;
if ( sc )
{
   scServices = sc->ServicesDependedOn;
}

if ( sc && scServices )
{
   // Display the services that the Messenger service is dependent on.
   if ( scServices->Length == 0 )
   {
      Console::WriteLine(  "{0} service is not dependent on any other services.", sc->ServiceName );
   }
   else
   {
      Console::WriteLine(  "{0} service is dependent on the following:", sc->ServiceName );
      for each (ServiceController^ scTemp in scServices)
      {
         Console::WriteLine(" {0}", scTemp->DisplayName);
      }
   }
}

ServiceController sc = new ServiceController("Messenger");
ServiceController[] scServices= sc.ServicesDependedOn;

// Display the services that the Messenger service is dependent on.
if (scServices.Length == 0)
{
   Console.WriteLine("{0} service is not dependent on any other services.",
                      sc.ServiceName);
}
else
{
   Console.WriteLine("{0} service is dependent on the following:",
                      sc.ServiceName);

   foreach (ServiceController scTemp in scServices)
   {
      Console.WriteLine(" {0}", scTemp.DisplayName);
   }
}


Dim sc As New ServiceController("Messenger")
Dim scServices As ServiceController() = sc.ServicesDependedOn

' Display the services that the Messenger service is dependent on.
If scServices.Length = 0 Then
   Console.WriteLine("{0} service is not dependent on any other services.", sc.ServiceName)
Else
   Console.WriteLine("{0} service is dependent on the following:", sc.ServiceName)
   
   Dim scTemp As ServiceController
   For Each scTemp In  scServices
      Console.WriteLine(" {0}", scTemp.DisplayName)
   Next scTemp
End If

Remarks

If any service in the ServicesDependedOn array is not running, you will not be able to start this service.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)

Share via