Método UserControlService de la clase Win32_BaseService
El método de clase WMI intenta enviar un código de control definido por el usuario a un servicio.
En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.
Sintaxis
uint32 UserControlService(
[in] uint8 ControlCode
);
Parámetros
-
ControlCode [in]
-
Valor que especifica un comando de control para un servicio. Por ejemplo, un comando de control es un comando "pause" o "continue". El valor puede ser un código predefinido, o un valor y una acción que define el servicio. A continuación se muestran los códigos de control predefinidos:
-
SERVICE_CONTROL_CONTINUE
-
Notifica a un servicio en pausa que se reanude.
-
SERVICE_CONTROL_INTERROGATE
-
Notifica a un servicio que informe de la información de estado actual al administrador de control de servicios.
-
SERVICE_CONTROL_NETBINDADD
-
Notifica a un servicio de red que hay un nuevo componente para el enlace.
-
SERVICE_CONTROL_NETBINDDISABLE
-
Notifica a un servicio de red que uno de sus enlaces está deshabilitado.
-
SERVICE_CONTROL_NETBINDENABLE
-
Notifica a un servicio de red que está habilitado un enlace deshabilitado.
-
SERVICE_CONTROL_NETBINDREMOVE
-
Notifica a un servicio de red que se ha quitado un componente para el enlace.
-
SERVICE_CONTROL_PARAMCHANGE
-
Notifica a un servicio que cambian sus parámetros de inicio.
-
SERVICE_CONTROL_PAUSE
-
Notifica a un servicio que se va a pausar.
-
SERVICE_CONTROL_STOP
-
Notifica a un servicio que se detenga.
Valor devuelto
Devuelve uno de los valores enumerados en la lista siguiente o un valor diferente para indicar un error.
-
Success
-
0
Se acepta la solicitud.
-
No compatible
-
1
No se admite la solicitud.
-
Acceso denegado
-
2
El usuario no tiene los derechos de acceso necesarios.
-
Servicios dependientes en ejecución
-
3
No se puede detener el servicio porque otros servicios que se están ejecutando dependen de él.
-
Control de servicio no válido
-
4
El código de control solicitado no es válido o no es aceptable para el servicio.
-
El servicio no puede aceptar el control
-
5
El código de control solicitado no se puede enviar al servicio porque el estado del servicio (Win32_BaseService. Propiedad State ) es igual a 0, 1 o 2.
-
Servicio no activo
-
6
No se inició el servicio.
-
Tiempo de espera de solicitud de servicio
-
7
El servicio no responde rápidamente a la solicitud de inicio.
-
Error desconocido
-
8
Proceso interactivo.
-
Ruta de acceso no encontrada
-
9
No se encuentra la ruta de acceso del directorio al archivo ejecutable del servicio.
-
Servicio que ya se está ejecutando
-
10
El servicio ya se está ejecutando.
-
Base de datos de servicio bloqueada
-
11
La base de datos para agregar un nuevo servicio está bloqueada.
-
Dependencia de servicio eliminada
-
12
Una dependencia en la que se basa este servicio se quita del sistema.
-
Error de dependencia del servicio
-
13
El servicio no encuentra el servicio necesario desde un servicio dependiente.
-
Servicio deshabilitado
-
14
El servicio está deshabilitado desde el sistema.
-
Error de inicio de sesión de servicio
-
15
El servicio no tiene la autenticación correcta para ejecutarse en el sistema.
-
Servicio marcado para eliminación
-
16
El servicio se va a quitar del sistema.
-
Servicio sin subproceso
-
17
No hay ningún subproceso de ejecución para el servicio.
-
Dependencia circular de estado
-
18
Hay dependencias circulares al iniciarse el servicio.
-
Nombre duplicado de estado
-
19
Hay un servicio que se ejecuta con el mismo nombre.
-
Estado Nombre no válido
-
20
Hay caracteres no válidos en el nombre del servicio.
-
Parámetro no válido de estado
-
21
Los parámetros no válidos se han pasado al servicio.
-
Estado Cuenta de servicio no válida
-
22
La cuenta en la que se ejecuta este servicio no es válida o no tiene los permisos para ejecutar el servicio.
-
El servicio de estado existe
-
23
El servicio existe en la base de datos de servicios disponibles del sistema.
-
El servicio ya está en pausa
-
24
El servicio se encuentra en pausa actualmente en el sistema.
-
Otros
-
25 4294967295
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|