Win32_BaseService 类的 UserControlService 方法

WMI 类方法尝试将用户定义的控件代码发送到服务。

本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。

语法

uint32 UserControlService(
  [in] uint8 ControlCode
);

参数

ControlCode [in]

指定服务控制命令的值。 例如，控件命令是“暂停”或“continue”命令。 该值可以是预定义代码，也可以是服务定义的值和操作。 下面是预定义的控制代码：

SERVICE_CONTROL_CONTINUE

通知暂停的服务继续。

SERVICE_CONTROL_INTERROGATE

通知服务向服务控制管理器报告当前状态信息。

SERVICE_CONTROL_NETBINDADD

通知网络服务有用于绑定的新组件。

SERVICE_CONTROL_NETBINDDISABLE

通知网络服务其其中一个绑定已禁用。

SERVICE_CONTROL_NETBINDENABLE

通知网络服务已启用禁用的绑定。

SERVICE_CONTROL_NETBINDREMOVE

通知网络服务已删除用于绑定的组件。

SERVICE_CONTROL_PARAMCHANGE

通知服务其启动参数已更改。

SERVICE_CONTROL_PAUSE

通知服务暂停。

SERVICE_CONTROL_STOP

通知服务停止。

返回值

返回以下列表中列出的值之一，或者返回指示错误的其他值。

Success

0

请求被接受。

不支持

1

不支持该请求。

拒绝访问

2

用户没有必要的访问权限。

正在运行的依赖服务

3

由于其他正在运行的服务依赖于该服务，不能停止该服务。

服务控件无效

4

请求的控制代码无效或服务无法接受该控制代码。

服务无法接受控制

5

无法将请求的控制代码发送到服务，因为服务的状态 (Win32_BaseService。状态 属性) 等于 0、1 或 2。

服务未处于活动状态

6

服务尚未启动。

服务请求超时

7

该服务不会快速响应启动请求。

未知失败

8

交互式进程。

找不到路径

9

找不到服务可执行文件的目录路径。

服务已在运行

10

服务已在运行。

服务数据库已锁定

11

要添加新服务的数据库已锁定。

已删除服务依赖项

12

此服务所依赖的依赖项将从系统中删除。

服务依赖项失败

13

该服务找不到依赖服务所需的服务。

服务已禁用

14

服务已从系统禁用。

服务登录失败

15

服务没有在该系统上运行所需的正确身份验证。

标记为要删除的服务

16

正在从系统删除此服务。

服务无线程

17

该服务没有执行线程。

状态循环依赖项

18

启动服务时存在循环依赖关系。

状态重复名称

19

已有一个同名的服务在运行。

状态名称无效

20

服务名称中有无效字符。

状态无效参数

21

传递给服务的参数无效。

服务帐户状态无效

22

运行此服务的帐户无效，或者没有运行服务的权限。

状态服务存在

23

系统的服务数据库中已存在该服务。

服务已暂停

24

该服务目前在系统中已暂停。

其他

25 4294967295

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

操作系统类

Win32_BaseService