ServiceController.GetServices Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera os serviços de driver que não são de dispositivo em um computador e aqueles que não são drivers.
Sobrecargas
| Nome | Description |
|---|---|
| GetServices(String) |
Recupera todos os serviços no computador especificado, exceto para os serviços de driver de dispositivo. |
| GetServices() |
Recupera todos os serviços no computador local, exceto os serviços de driver de dispositivo. |
GetServices(String)
Recupera todos os serviços no computador especificado, exceto para os serviços de driver de dispositivo.
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()
Parâmetros
- machineName
- String
O computador do qual recuperar os serviços.
Retornos
Uma matriz de tipo ServiceController na qual cada elemento está associado a um serviço no computador especificado.
Exceções
Ocorreu um erro ao acessar uma API do sistema.
O machineName parâmetro tem sintaxe inválida.
Comentários
GetServices retorna apenas os serviços de driver que não são de dispositivo e os serviços que não são drivers do computador especificado. Para recuperar os serviços de driver de dispositivo, chame o GetDevices método. Juntos, os dois métodos fornecem acesso a todos os serviços em um computador.
Confira também
Aplica-se a
GetServices()
Recupera todos os serviços no computador local, exceto os serviços de driver de dispositivo.
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()
Retornos
Uma matriz de tipo ServiceController na qual cada elemento está associado a um serviço no computador local.
Exceções
Ocorreu um erro ao acessar uma API do sistema.
Exemplos
O exemplo a seguir usa a ServiceController classe para exibir os serviços em execução no computador 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
Comentários
GetServices retorna apenas os serviços de driver que não são dispositivos e os serviços que não são drivers do computador local. Para recuperar os serviços de driver de dispositivo, chame o GetDevices método. Juntos, os dois métodos fornecem acesso a todos os serviços em um computador.