ServiceController.GetServices Méthode

Définition

Récupère les services de pilotes non-périphériques sur un ordinateur et ceux qui ne sont pas des pilotes.

Surcharges

Nom Description
GetServices(String)

Récupère tous les services sur l’ordinateur spécifié, à l’exception des services de pilote de périphérique.

GetServices()

Récupère tous les services sur l’ordinateur local, à l’exception des services de pilote de périphérique.

GetServices(String)

Récupère tous les services sur l’ordinateur spécifié, à l’exception des services de pilote de périphérique.

public:
 static cli::array <System::ServiceProcess::ServiceController ^> ^ GetServices(System::String ^ machineName);
public static System.ServiceProcess.ServiceController[] GetServices(string machineName);
static member GetServices : string -> System.ServiceProcess.ServiceController[]
Public Shared Function GetServices (machineName As String) As ServiceController()

Paramètres

machineName
String

Ordinateur à partir duquel récupérer les services.

Retours

Tableau de type ServiceController dans lequel chaque élément est associé à un service sur l’ordinateur spécifié.

Exceptions

Une erreur s’est produite lors de l’accès à une API système.

Le machineName paramètre a une syntaxe non valide.

Remarques

GetServices retourne uniquement les services de pilotes non-périphérique et les services qui ne sont pas des pilotes de l’ordinateur spécifié. Pour récupérer les services de pilote de périphérique, appelez la GetDevices méthode. Ensemble, les deux méthodes permettent d’accéder à tous les services sur un ordinateur.

Voir aussi

S’applique à

GetServices()

Récupère tous les services sur l’ordinateur local, à l’exception des services de pilote de périphérique.

public:
 static cli::array <System::ServiceProcess::ServiceController ^> ^ GetServices();
public static System.ServiceProcess.ServiceController[] GetServices();
static member GetServices : unit -> System.ServiceProcess.ServiceController[]
Public Shared Function GetServices () As ServiceController()

Retours

Tableau de type ServiceController dans lequel chaque élément est associé à un service sur l’ordinateur local.

Exceptions

Une erreur s’est produite lors de l’accès à une API système.

Exemples

L’exemple suivant utilise la ServiceController classe pour afficher les services en cours d’exécution sur l’ordinateur local.

array<ServiceController^>^scServices = ServiceController::GetServices();

// Display the list of services currently running on this computer.
Console::WriteLine(  "Services running on the local computer:" );
for each (ServiceController^ scTemp in scServices)
{
   if ( scTemp->Status == ServiceControllerStatus::Running )
   {
      // Write the service name and the display name
      // for each running service.
      Console::WriteLine();
      Console::WriteLine(  "  Service :        {0}", scTemp->ServiceName );
      Console::WriteLine(  "    Display name:    {0}", scTemp->DisplayName );

      // Query WMI for additional information about this service.
      // Display the start name (LocalSystem, etc) and the service
      // description.
      ManagementObject^ wmiService;
      String^ objPath;
      objPath = String::Format( "Win32_Service.Name='{0}'", scTemp->ServiceName );
      wmiService = gcnew ManagementObject( objPath );
      if ( wmiService )
      {
         wmiService->Get();
         Object^ objStartName = wmiService["StartName"];
         Object^ objDescription = wmiService["Description"];
         if ( objStartName )
         {
            Console::WriteLine(  "    Start name:      {0}", objStartName->ToString() );
         }
         if ( objDescription )
         {
            Console::WriteLine(  "    Description:     {0}", objDescription->ToString() );
         }
      }
   }
}
ServiceController[] scServices;
scServices = ServiceController.GetServices();

// Display the list of services currently running on this computer.

Console.WriteLine("Services running on the local computer:");
foreach (ServiceController scTemp in scServices)
{
   if (scTemp.Status == ServiceControllerStatus.Running)
   {
      // Write the service name and the display name
      // for each running service.
      Console.WriteLine();
      Console.WriteLine("  Service :        {0}", scTemp.ServiceName);
      Console.WriteLine("    Display name:    {0}", scTemp.DisplayName);

      // Query WMI for additional information about this service.
      // Display the start name (LocalSystem, etc) and the service
      // description.
      ManagementObject wmiService;
      wmiService = new ManagementObject("Win32_Service.Name='" + scTemp.ServiceName + "'");
      wmiService.Get();
      Console.WriteLine("    Start name:      {0}", wmiService["StartName"]);
      Console.WriteLine("    Description:     {0}", wmiService["Description"]);
   }
}

   Dim scServices() As ServiceController
   scServices = ServiceController.GetServices()
 
   ' Display the list of services currently running on this computer.
   Console.WriteLine("Services running on the local computer:")

   Dim scTemp As ServiceController
   For Each scTemp In  scServices

      If scTemp.Status = ServiceControllerStatus.Running Then
         ' Write the service name and the display name
         ' for each running service.
         Console.WriteLine()
         Console.WriteLine("  Service :        {0}", scTemp.ServiceName)
         Console.WriteLine("    Display name:    {0}", scTemp.DisplayName)
         
         ' Query WMI for additional information about this service.
         ' Display the start name (LocalSystem, etc) and the service
         ' description.
         Dim wmiService As ManagementObject
         wmiService = New ManagementObject("Win32_Service.Name='" + scTemp.ServiceName + "'")
         wmiService.Get()
         Console.WriteLine("    Start name:      {0}", wmiService("StartName"))
         Console.WriteLine("    Description:     {0}", wmiService("Description"))
      End If

   Next scTemp

Remarques

GetServices retourne uniquement les services de pilotes non-périphériques et les services qui ne sont pas des pilotes de l’ordinateur local. Pour récupérer les services de pilote de périphérique, appelez la GetDevices méthode. Ensemble, les deux méthodes permettent d’accéder à tous les services sur un ordinateur.

Voir aussi

S’applique à