ServiceController.DependentServices Property

Definition

Gets the set of services that depends on the service associated with this ServiceController instance.

public:
 property cli::array <System::ServiceProcess::ServiceController ^> ^ DependentServices { cli::array <System::ServiceProcess::ServiceController ^> ^ get(); };
public System.ServiceProcess.ServiceController[] DependentServices { get; }
[System.ServiceProcess.ServiceProcessDescription("SPDependentServices")]
public System.ServiceProcess.ServiceController[] DependentServices { get; }
member this.DependentServices : System.ServiceProcess.ServiceController[]
[<System.ServiceProcess.ServiceProcessDescription("SPDependentServices")>]
member this.DependentServices : System.ServiceProcess.ServiceController[]
Public ReadOnly Property DependentServices As ServiceController()

Property Value

An array of ServiceController instances, each of which is associated with a service that depends on this service.

Attributes

Exceptions

An error occurred when accessing a system API.

The service was not found.

Examples

The following example uses the ServiceController class to display the set of services that are dependent on the Event Log service.

ServiceController^ sc = gcnew ServiceController(  "Event Log" );
array<ServiceController^>^scServices = nullptr;
if ( sc )
{
   scServices = sc->DependentServices;
}

if ( sc && scServices )
{
   // Display the list of services dependent on the Event Log service.
   if ( scServices->Length == 0 )
   {
      Console::WriteLine(  "There are no services dependent on {0}", sc->ServiceName );
   }
   else
   {
      Console::WriteLine(  "Services dependent on {0}:", sc->ServiceName );
      for each (ServiceController^ scTemp in scServices)
      {
         Console::WriteLine(" {0}", scTemp->DisplayName);
      }
   }
}

ServiceController sc =  new ServiceController("Event Log");
ServiceController[] scServices = sc.DependentServices;

// Display the list of services dependent on the Event Log service.
if (scServices.Length == 0)
{
   Console.WriteLine("There are no services dependent on {0}",
                      sc.ServiceName);
}
else
{
   Console.WriteLine("Services dependent on {0}:",
                      sc.ServiceName);

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

Dim sc As New ServiceController("Event Log")
Dim scServices As ServiceController() = sc.DependentServices

' Display the list of services dependent on the Event Log service.
If scServices.Length = 0 Then
   Console.WriteLine("There are no services dependent on {0}", sc.ServiceName)
Else
   Console.WriteLine("Services dependent on {0}:", sc.ServiceName)
   
   Dim scTemp As ServiceController
   For Each scTemp In  scServices
      Console.WriteLine(" {0}", scTemp.DisplayName)
   Next scTemp
End If

Remarks

The DependentServices array represents the services that the system stops if your application calls Stop for this service.

Applies to