Metodo ResumeService della classe Win32_Service (provider WMI CIMWin32)

Articolo
11/30/2023

Il metodo della classe WMI ResumeServicetenta di posizionare il servizio a cui si fa riferimento nello stato ripreso.

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 ResumeService();

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:

Anche se potrebbe non esserci alcuna differenza pratica tra un servizio arrestato e un servizio sospeso, i due stati vengono visualizzati in modo diverso rispetto a SCM. Un servizio arrestato è un servizio che non è in esecuzione e deve eseguire l'intera procedura di avvio del servizio. Un servizio sospeso, tuttavia, è ancora in esecuzione, ma il funzionamento è sospeso. Per questo motivo, un servizio sospeso non deve eseguire l'intera procedura di avvio del servizio, ma richiede una procedura diversa per riprendere il funzionamento.

È necessario utilizzare il metodo appropriato per avviare un servizio arrestato o per riprendere un servizio sospeso. I metodi Win32_Service StartService e ResumeService devono essere usati nelle situazioni seguenti:

Se un servizio è attualmente arrestato, è necessario usare il metodo StartService per riavviarlo; ResumeService non può avviare un servizio attualmente arrestato.
Se un servizio è in pausa, è necessario usare ResumeService. Se si usa il metodo StartService in un servizio sospeso, viene visualizzato il messaggio "Il servizio è già in esecuzione". Tuttavia, il servizio rimane sospeso fino a quando non viene inviato il codice di controllo del servizio di ripresa.

Esempi

Nell'esempio di codice VBScript seguente viene descritto come riprendere un servizio sospeso da istanze di Win32_Service.

Nota

Il servizio deve supportare la sospensione e l'esecuzione già in esecuzione.

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

for each Service in ServiceSet
 SupportsPause = Service.AcceptPause
 if SupportsPause = true then
  RetVal = Service.ResumeService()
  if RetVal = 0 then 
   WScript.Echo "Service resumed"   
  else
   if RetVal = 1 then 
    WScript.Echo "Pause not supported" 
   else WScript.Echo "An error occurred:" & RetVal
   End If
  End If
 else
  WScript.Echo "Service does not support pause"
 end if
next

Nell'esempio di codice Perl seguente viene descritto come riprendere un servizio sospeso da istanze di Win32_Service.

Nota

Il servizio deve supportare la sospensione e l'esecuzione già in esecuzione.

use strict;
use Win32::OLE;

my $ServiceSet;

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

if (!$@ && defined $ServiceSet)
{
 foreach my $Service (in $ServiceSet)
 {
  my $SupportsPause = $Service->{AcceptPause};
  if ($SupportsPause)
  {
   my $RetVal = $Service->ResumeService();
   if ($RetVal == 0)
   {
    print "\nService resumed\n";
   }
   else
   {
    if ($RetVal == 1)
    {
     print STDERR "\nPause not supported\n";
    }
    else
    {
     print STDERR "\nAn error occurred: ", $RetVal, "\n";
    }
   }
  }
  else
  {
   print "\nService does not support pause\n";
  }
 }
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

Requisiti

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

Vedi anche

Classi del sistema operativo
Win32_service
Attività WMI: Servizi

Condividi tramite