ServiceController::ServicesDependedOn 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.

The set of services that this service depends on.

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

public:
[ServiceProcessDescriptionAttribute("SPServicesDependedOn")]
property array<ServiceController^>^ ServicesDependedOn {
	array<ServiceController^>^ get();
}

Property Value

Type: array<System.ServiceProcess::ServiceController^>^

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

Exception Condition
Win32Exception

An error occurred when accessing a system API.

InvalidOperationException

The service was not found.

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

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);
      }
   }
}

ServiceControllerPermission

for connecting to existing services on the computer. Associated enumeration: ServiceControllerPermissionAccess::Browse

.NET Framework
Available since 1.1
Return to top
Show: