Metodo PauseService della classe Win32_Service (provider WMI CIMWin32)

Articolo
11/30/2023

Il metodo della classe WMI PauseServicetenta di posizionare il servizio nello stato sospeso.

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

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.

Esempi

Nell'esempio di codice VBScript seguente viene illustrato come sospendere un servizio specifico 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.PauseService()
  if RetVal = 0 then 
   WScript.Echo "Service paused"   
  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 illustrato come sospendere un servizio specifico 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, $SupportsPause, $RetVal);  
eval {$ServiceSet = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\Root\\CIMv2")->
 ExecQuery("SELECT * FROM Win32_Service WHERE Name='Schedule'"); };
unless($@)
{
 foreach my $ServiceInst (in $ServiceSet)
 {
  if ($ServiceInst->{AcceptPause})
  {
   $RetVal = $ServiceInst->PauseService();
   if ($RetVal == 0)
   {
    print "\nService paused\n";
   }
   else
   {
    if ($RetVal == 1)
    {
     print "\nPause not supported\n" ;
    }
    else 
    {
     print "\nAn error occurred:", $RetVal, "\n";
    }
   } 
  }
  else
  {
   print "\nService does not support pause\n";
  }
 }
}
else
{
 print STDERR "\n", 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
StopService

Condividi tramite