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 |
|
DLL |
|