Win32_BaseService.Change (WMI)

Change 方法用于修改服务。Win32_LoadOrderGroup 参数表示一组定义了执行相关性的系统服务。由于这类服务彼此相互依赖,它们必须按照加载顺序组给定的顺序启动。为了能正确工作,这类依存服务要求先行服务已存在。如果服务修改成功,则 Change 返回整数值 0;如果请求未得到支持,则返回 1 或任何其他的数字表示发生了错误。
语法

return_value = object.Change

(
NameAs String,
DisplayNameAs String,
PathNameAs String,
ServiceTypeAs Integer,
ErrorControlAs Integer,
StartModeAs String,
DesktopInteractAs Boolean,
StartNameAs String,
StartPasswordAs String,
LoadOrderGroupAs String,
LoadOrderGroupDependenciesAs Array,
ServiceDependenciesAs Array _)
参数

BaseService
可解析为 Win32_BaseService 实例的表达式。

Name
[in] 要安装到 Change 方法中的服务名称。最大字符串长度为 256 个字符。服务控制管理程序数据库保留字符的大小写,但服务名称比较始终是不区分大小写的。正斜杠 (/) 和双反斜杠 (\) 是无效的服务名称字符。

DisplayName
[in] 服务的显示名称。此字符串的最大长度为 256 个字符。名称在服务控制管理程序中保留大小写。DisplayName 比较始终区分大小写。限制:接受与 Name 参数相同的值。示例:“Atdisk”。

PathName
[in] 到实施服务的可执行文件的完全限定的路径。示例:“\SystemRoot\System32\drivers\afd.sys”。

ServiceType
[in] 给调用服务的进程提供的服务类型。

含义
0 内核驱动程序
1 文件系统驱动程序
2 适配器
3 识别器驱动程序
4 自有进程
5 Win32 共享进程
8



ErrorControl
[in] 此服务在启动时失败所产生的错误的严重性。该值指示在发生故障时启动程序所执行的操作。系统记录所有的错误。

含义
Ignore 不通知用户。
Normal 通知用户。
Severe 系统使用最新的有效配置重新启动。
Critical 系统试图使用有效的配置重新启动。



StartMode
[in] Win32 基本服务的启动模式。

含义
Boot 由操作系统加载程序启动设备驱动程序。
System IoInitSystem 方法启动设备驱动程序。此值仅对驱动程序服务有效。
Automatic 服务控制管理程序在系统启动过程中自动启动的服务。
Manual 在进程调用 StartService 方法时由服务控制管理程序启动的服务。
Disabled 无法再进行启动的服务。



DesktopInteract
[in] 表示服务是否可以在桌面上创建窗口或与桌面上的窗口进行通信。

StartName
[in] 服务运行时所使用的帐户名。根据服务种类,帐户名可以采用 DomainName\Username 的格式,在运行时将使用这两个格式之一记录服务进程。如果帐户属于内置域,则可以指定 .\Username。如果指定 NULL,则该服务以 LocalSystem 帐户登录。对于内核或系统级别的驱动程序,StartName 包含驱动程序对象名称(即,\FileSystem\Rdr 或 \Driver\Xns),输入和输出 (I/O) 系统可使用该名称来加载设备驱动程序。如果指定了 NULL,则驱动程序运行时使用 I/O 系统基于服务名称创建的默认对象名称。示例:DWDOM\Admin。

StartPassword
[in] 参数 StartName 指定的帐户名的密码。如果不想更改该密码,则指定 NULL。如果服务没有密码,则指定一个空字符串。

LoadOrderGroup
[in] 它所关联的组名。加载顺序组包含在系统注册表中,可用于确定将服务加载到操作系统中的顺序。如果指针为 NULL 或指向一个空白字符串,则该服务不属于组。组之间的相关性应该列在 LoadOrderGroupDependencies 参数中。首先启动加载顺序组列表中的服务,然后启动属于组且不在加载顺序组列表中的服务,最后启动不属于组的服务。系统注册表的加载顺序组列表位于 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ServiceGroupOrder

LoadOrderGroupDependencies
[in, String] 必须在该服务之前启动的加载顺序组列表。该数组是双位 null 终止的。如果指针为 NULL 或指向一个空白字符串,则该服务没有相关性。因为服务和服务组共享同一名称空间,所以组名必须包含前缀 SC_GROUP_IDENTIFIER(在 WINSVC.H 文件中定义)字符以区别于其他服务名称。组的相关性是指在试图启动该组的所有成员后,要使该服务能够运行,必须至少有一个组成员正在运行。

ServiceDependencies
[in, String] 包含必须在该服务之前启动的服务的名称列表。该数组是双位 null 终止的。如果指针为 NULL 或指向一个空白字符串,则该服务没有相关性。对服务的相关性是指,仅当所依赖的服务正在运行时才能运行该服务。

相关主题

© 1997-2003 Microsoft Corporation。保留所有权利