Metodo StopService della classe Win32_Service (Sdoias.h)

Articolo
11/30/2023

Il metodo della classe WMI StopServiceinserisce il servizio, rappresentato dall'oggetto Win32_Service, nello stato arrestato.

In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.

Sintassi

uint32 StopService();

Parametri

Questo metodo non presenta parametri.

Valore restituito

Restituisce uno dei valori elencati nell'elenco seguente o qualsiasi altro valore per indicare un errore. Per altri codici di errore, vedere Costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.

0: La richiesta è stata accettata.
1: La richiesta non è supportata.
2: L'utente non ha ottenuto l'accesso necessario.
3: Impossibile arrestare il servizio perché altri servizi in esecuzione dipendono dal servizio.
4: Il codice di controllo richiesto non è valido o non è accettabile per il servizio.
5: Impossibile inviare il codice di controllo richiesto al servizio perché lo stato del servizio (Win32_BaseService.Proprietà state ) è uguale a 0, 1 o 2.
6: Il servizio non è stato avviato.
7: Il servizio non ha risposto in tempo utile alla richiesta di avvio.
8: Errore sconosciuto durante l'avvio del servizio.
9: Impossibile trovare il percorso della directory del file eseguibile del servizio.
10: Il servizio è già in esecuzione.
11: Il database a cui aggiungere il nuovo servizio è bloccato.
12: Una dipendenza da cui si basa questo servizio è stata rimossa dal sistema.
13: Impossibile trovare un servizio dipendente necessario.
14: Il servizio è stato disabilitato dal sistema.
15: Il servizio non dispone delle credenziali di autenticazione corrette per l'esecuzione nel sistema.
16: Questo servizio viene rimosso dal sistema.
17: Il servizio non ha thread di esecuzione.
18: Il servizio ha dipendenze circolari all'avvio.
19: Un servizio viene eseguito con lo stesso nome.
20: Il nome del servizio ha caratteri non validi.
21: I parametri non validi sono stati passati al servizio.
22: L'account con cui viene eseguito il servizio non è valido o non dispone delle autorizzazioni per l'esecuzione del servizio.
23: Il servizio esiste già nel database dei servizi disponibili dal sistema.
24: Il servizio è attualmente sospeso nel sistema.

Osservazioni:

Dopo aver determinato quali servizi possono essere arrestati o sospesi, è possibile usare i metodi StopService e PauseService per arrestare e sospendere i servizi. La decisione di arrestare un servizio anziché sospenderla o viceversa dipende da diversi fattori, tra cui i seguenti:

Il servizio è in grado di essere sospeso? In caso contrario, l'unica opzione è arrestare il servizio.
È necessario continuare a gestire le richieste client per chiunque sia già connesso al servizio? In tal caso, la sospensione di un servizio consente in genere di gestire i client esistenti negando l'accesso ai nuovi client. Al contrario, quando si arresta un servizio, tutti i client vengono immediatamente disconnessi.
È necessario riconfigurare un servizio e rendere immediatamente effettive le modifiche? Anche se le proprietà del servizio possono essere modificate durante la sospensione di un servizio, la maggior parte di esse non diventa effettiva finché il servizio non viene effettivamente arrestato e riavviato.

Il codice di scripting necessario per arrestare un servizio è quasi identico al codice necessario per sospendere il servizio.

Se si tenta di arrestare un servizio con servizi dipendenti in esecuzione, il metodo StopService ha esito negativo con un valore restituito pari a 3. I servizi dipendenti devono essere arrestati per primi.

Se si arresta un servizio, controllare immediatamente il Win32_Service.Proprietà State , perché il valore può comunque mostrare il servizio come in esecuzione.

Esempi

Nell'esempio di codice VBScript seguente viene illustrato come arrestare un servizio.

Set ServiceSet = GetObject("winmgmts:").ExecQuery("select * from Win32_Service where Name='ClipSrv'")

for each Service in ServiceSet
 RetVal = Service.StopService()
 if RetVal = 0 then 
  WScript.Echo "Service stopped" 
 elseif RetVal = 5 then 
  WScript.Echo "Service already stopped" 
 end if
next

Nell'esempio di codice Perl seguente viene illustrato come arrestare un servizio.

use strict;
use Win32::OLE;

my $ServiceSet;

eval { $ServiceSet = 
 Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
 ExecQuery("SELECT * FROM Win32_Service WHERE Name='ClipSrv'"); };

if (!$@ && defined $ServiceSet)
{
 foreach my $ServiceInst (in $ServiceSet)
 {
  my $Result = $ServiceInst->StopService();
  if ($Result == 0)
  {
   print "\nService stopped\n";
  }
  elsif ($Result == 5) 
  {
   print "\nService already stopped\n";
  }
 }
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

L'esempio di codice VBScript seguente mostra che non è possibile arrestare il servizio NetDDE fino a quando i servizi dipendenti non sono stati arrestati. Per eseguire lo script, assicurarsi che il servizio NetDDE e i relativi servizi dipendenti siano in esecuzione usando lo snap-in MMC Services.msc o il comando Net Start .

La classe Win32_DependentService consente di individuare le dipendenze del servizio tramite una query Associators Of .

strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
    & "{impersonationLevel=impersonate}!\\" & _
    strComputer & "\root\cimv2")

Set objNetDDEservice = _
    objWMIService.Get("Win32_Service.Name='NetDDE'")

WScript.Echo "NetDDE service state: " & objNetDDEService.State
WScript.Echo "Stopping NetDDE service"
Return = objNetDDEService.StopService()
WScript.Echo "Return value: " & Return  & _
    "  Service cannot be stopped because " & _
    "dependent services are running"

Set colServiceList = objWMIService.ExecQuery("Associators of " _
    & "{Win32_Service.Name='NetDDE'} Where " _
        & "AssocClass=Win32_DependentService " & _
    "Role=Antecedent" )

For Each objService in colServiceList
   WScript.Echo "Dependent service: " & objService.Name & _
   "   State: " & objService.State
   WScript.Echo "Stopping dependent service " & objService.Name
   objService.StopService()    
Next

Wscript.Sleep 20000
WScript.Echo "Stopping NetDDE service"
Return = objNetDDEService.StopService()
WScript.Echo "Return value: " & Return

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\CIMV2
Intestazione	Sdoias.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo
Win32_service
Attività WMI: Servizi
PauseService