Método UserControlService de la clase Win32_BaseService

Artículo
06/03/2023

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

Se acepta la solicitud.

No compatible

No se admite la solicitud.

Acceso denegado

El usuario no tiene los derechos de acceso necesarios.

Servicios dependientes en ejecución

No se puede detener el servicio porque otros servicios que se están ejecutando dependen de él.

Control de servicio no válido

El código de control solicitado no es válido o no es aceptable para el servicio.

El servicio no puede aceptar el control

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

No se inició el servicio.

Tiempo de espera de solicitud de servicio

El servicio no responde rápidamente a la solicitud de inicio.

Error desconocido

Proceso interactivo.

Ruta de acceso no encontrada

No se encuentra la ruta de acceso del directorio al archivo ejecutable del servicio.

Servicio que ya se está ejecutando

El servicio ya se está ejecutando.

Base de datos de servicio bloqueada

La base de datos para agregar un nuevo servicio está bloqueada.

Dependencia de servicio eliminada

Una dependencia en la que se basa este servicio se quita del sistema.

Error de dependencia del servicio

El servicio no encuentra el servicio necesario desde un servicio dependiente.

Servicio deshabilitado

El servicio está deshabilitado desde el sistema.

Error de inicio de sesión de servicio

El servicio no tiene la autenticación correcta para ejecutarse en el sistema.

Servicio marcado para eliminación

El servicio se va a quitar del sistema.

Servicio sin subproceso

No hay ningún subproceso de ejecución para el servicio.

Dependencia circular de estado

Hay dependencias circulares al iniciarse el servicio.

Nombre duplicado de estado

Hay un servicio que se ejecuta con el mismo nombre.

Estado Nombre no válido

Hay caracteres no válidos en el nombre del servicio.

Parámetro no válido de estado

Los parámetros no válidos se han pasado al servicio.

Estado Cuenta de servicio no válida

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

El servicio existe en la base de datos de servicios disponibles del sistema.

El servicio ya está en pausa

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

Consulte también

Clases de sistema operativo
Win32_BaseService

Share via