Win32_Service 类的 ChangeStartMode 方法 (CIMWin32 WMI 提供程序)

  • 项目

ChangeStartModeWMI 类方法修改Win32_Service的启动模式。

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

语法

uint32 ChangeStartMode(
  [in] string StartMode = Auto Start
);

参数

StartMode [in]

Windows 基本服务的启动模式。

启动 (“启动”)

操作系统加载程序启动的设备驱动程序。 此值只对驱动程序服务有效。

系统 (“系统”)

由操作系统初始化过程启动的设备驱动程序。 此值只对驱动程序服务有效。

自动启动 (“自动”)

服务将在系统启动期间由服务控制管理器自动启动。

需求启动 (“手动”)

当进程调用 StartService 方法时由服务控制管理器启动的服务。

disabled (“Disabled”)

无法再启动的服务。

返回值

返回以下列表中列出的值之一或指示错误的任何其他值。 有关其他错误代码，请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值，请参阅 系统错误代码。

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

示例

从 TechNet 库拉取的服务 PowerShell 示例 的以下更改 StartMode 更改服务的启动模式。

$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon | 
where-object { $_.name -eq 'bits' } 
 
$rtn = $wmi.changestartmode("manual") 
if($rtn.returnvalue -eq 0) { "success" } 
ELSE 
  { " $($rtn.returnvalue) was reported" }

要求

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

另请参阅

操作系统类

Win32_Service

WMI 任务：服务