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	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo

Win32_BaseService