Win32_Service 类的 ChangeStartMode 方法 (远程桌面服务)

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

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

语法

uint32 ChangeStartMode(
  [in] string StartMode
);

参数

StartMode [in]

Windows 基本服务的启动模式。

引导

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

系统

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

自动

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

手动

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

禁用

无法再启动的服务。

返回值

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

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

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

示例

以下从 TechNet 库提取的服务 PowerShell 示例 的 Change 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\TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

另请参阅

Win32_Service

操作系统类

Win32_TerminalService

WMI 任务:服务