Metodo UserControlService della classe Win32_BaseService
Il metodo della classe WMI tenta di inviare un codice di controllo definito dall'utente a un servizio.
Questo argomento usa la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 UserControlService(
[in] uint8 ControlCode
);
Parametri
-
ControlCode [in]
-
Valore che specifica un comando di controllo a un servizio. Ad esempio, un comando di controllo è un comando "pausa" o "continua". Il valore può essere un codice predefinito o un valore e un'azione che il servizio definisce. Di seguito sono riportati i codici di controllo predefiniti:
-
SERVICE_CONTROL_CONTINUE
-
Notifica a un servizio sospeso di riprendere.
-
SERVICE_CONTROL_INTERROGATE
-
Notifica a un servizio di segnalare le informazioni sullo stato correnti al gestore del controllo del servizio.
-
SERVICE_CONTROL_NETBINDADD
-
Notifica a un servizio di rete che esiste un nuovo componente per l'associazione.
-
SERVICE_CONTROL_NETBINDDISABLE
-
Notifica a un servizio di rete che uno dei relativi binding è disabilitato.
-
SERVICE_CONTROL_NETBINDENABLE
-
Notifica a un servizio di rete che un'associazione disabilitata è abilitata.
-
SERVICE_CONTROL_NETBINDREMOVE
-
Notifica a un servizio di rete che è stato rimosso un componente per l'associazione.
-
SERVICE_CONTROL_PARAMCHANGE
-
Notifica a un servizio che i parametri di avvio vengono modificati.
-
SERVICE_CONTROL_PAUSE
-
Notifica a un servizio di sospendere.
-
SERVICE_CONTROL_STOP
-
Notifica a un servizio di arresto.
Valore restituito
Restituisce uno dei valori elencati nell'elenco seguente o un valore diverso per indicare un errore.
-
Success
-
0
La richiesta viene accettata.
-
Non supportato
-
1
La richiesta non è supportata.
-
Accesso negato
-
2
L'utente non dispone dei diritti di accesso necessari.
-
Servizi dipendenti in esecuzione
-
3
Impossibile arrestare il servizio perché altri servizi in esecuzione dipendono dal servizio.
-
Controllo del servizio non valido
-
4
Il codice di controllo richiesto non è valido o non è accettabile per il servizio.
-
Il servizio non può accettare il controllo
-
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.
-
Servizio non attivo
-
6
Servizio non avviato.
-
Timeout della richiesta di servizio
-
7
Il servizio non risponde rapidamente alla richiesta iniziale.
-
Errore sconosciuto
-
8
Processo interattivo.
-
Percorso non trovato
-
9
Il percorso della directory del file eseguibile del servizio non viene trovato.
-
Servizio già in esecuzione
-
10
Il servizio è già in esecuzione.
-
Database di servizio bloccato
-
11
Il database a cui aggiungere il nuovo servizio è bloccato.
-
Dipendenza del servizio eliminata
-
12
Una dipendenza basata su questo servizio viene rimossa dal sistema.
-
Errore di dipendenza del servizio
-
13
Il servizio non trova il servizio necessario da un servizio dipendente.
-
Servizio disabilitato
-
14
Il servizio è disabilitato dal sistema.
-
Accesso al servizio non riuscito
-
15
Il servizio non dispone delle credenziali di autenticazione corrette per l'esecuzione nel sistema.
-
Servizio contrassegnato per l'eliminazione
-
16
Il servizio verrà rimosso dal sistema.
-
Nessun thread del servizio
-
17
Nessun thread di esecuzione per il servizio.
-
Dipendenza circolare dello stato
-
18
All'avvio del servizio sono state rilevate dipendenze circolari.
-
Nome duplicato stato
-
19
È presente un servizio in esecuzione con lo stesso nome.
-
Nome non valido dello stato
-
20
Esistono caratteri non validi nel nome del servizio.
-
Parametro stato non valido
-
21
I parametri non validi sono passati al servizio.
-
Account del servizio non valido stato
-
22
L'account in cui viene eseguito il servizio non è valido o non dispone delle autorizzazioni per eseguire il servizio.
-
Servizio di stato esistente
-
23
Il servizio esiste già nel database dei servizi disponibili dal sistema.
-
Servizio già sospeso
-
24
Il servizio è attualmente sospeso nel sistema.
-
Altri
-
25 4294967295
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|