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[]
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