Metodo StartService della classe Win32_Service (Servizi Desktop remoto)
Il metodo StartService tenta di inserire il servizio di riferimento nello stato di avvio.
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 StartService();
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 avuto 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 all'avvio del servizio.
-
9
-
Il percorso della directory del file eseguibile del servizio non è stato trovato.
-
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 alcun 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 contiene 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.
Commenti
Anche se potrebbe sembrare che non esista alcuna differenza pratica tra un servizio arrestato e un servizio sospeso, i due stati vengono visualizzati in modo diverso in 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 usare il metodo appropriato per avviare un servizio arrestato o per riprendere un servizio sospeso. I metodi Win32_ServiceStartService 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 è sospeso, è 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.
Se si avvia un servizio arrestato che dipende da un altro servizio, vengono avviati entrambi i servizi. Quando un servizio viene avviato con questo metodo, tutti i servizi dipendenti non vengono avviati automaticamente. È necessario usare la classe di associazione Win32_DependentService e gli associati della query Of per individuare i dipendenti e avviarli separatamente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|