Win32_BaseService 类的 Create 方法

项目
06/12/2023

CreateWMI 类方法创建新服务。 LoadOrderGroup 参数表示定义执行依赖项的系统服务的分组。服务必须按加载顺序组指定的顺序启动，因为服务相互依赖。这些依赖服务需要存在前面的服务才能正常运行。

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

语法

uint32 Create(
  [in] string  Name,
  [in] string  DisplayName,
  [in] string  PathName,
  [in] uint8   ServiceType,
  [in] uint8   ErrorControl,
  [in] string  StartMode,
  [in] boolean DesktopInteract,
  [in] string  StartName,
  [in] string  StartPassword,
  [in] string  LoadOrderGroup,
  [in] string  LoadOrderGroupDependencies[],
  [in] string  ServiceDependencies[]
);

参数

Name [in]

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

DisplayName [in]

服务的显示名称。此字符串的最大长度为 256 个字符。名称在服务控制管理器中保留大小写。 DisplayName 比较始终不区分大小写。

约束：接受与 Name 参数相同的值。

示例：“Atdisk”。

PathName [in]

实现服务的可执行文件的完全限定路径。

示例：“\SystemRoot\System32\drivers\afd.sys”。

ServiceType [in]

提供给调用它们的进程的服务类型。值为位图。

内核驱动程序 (1)

文件系统驱动程序 (2)

适配器 (4)

识别器驱动程序 (8)

自己的进程 (16)

共享进程 (32)

256

交互式进程

ErrorControl [in]

如果 Create 方法无法启动，则错误的严重性。该值指示启动程序在发生故障时采取的操作。所有错误都由系统记录。

忽略 (0)

不通知用户。

正常 (1)

通知用户。

严重 (2)

使用上一次已知正确的配置重新启动系统。

关键 (3)

系统尝试从良好的配置开始。

StartMode [in]

Windows 基本服务的启动模式。

启动 (“启动”)

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

系统启动 (“系统”)

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

自动启动 (“自动”)

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

需求启动 (“手动”)

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

禁用 (“Disabled”)

无法再启动的服务。

DesktopInteract [in]

如果 为 true，则服务可以在桌面上创建或与窗口通信。

StartName [in]

运行服务的帐户名称。根据服务类型，帐户名称可能采用“DomainName\Username”的形式。服务进程在运行时使用这两种形式之一进行记录。如果帐户属于内置域，则可以指定“.\Username”。如果指定 NULL ，则服务将作为 LocalSystem 帐户登录。对于内核或系统级驱动程序， StartName 包含驱动程序对象名称 (即 \FileSystem\Rdr 或 \Driver\Xns) ， (I/O) 系统用来加载设备驱动程序。如果指定 NULL ，则驱动程序使用 I/O 系统基于服务名称创建的默认对象名称运行。示例：DWDOM\管理员。

StartPassword [in]

由 StartName 参数指定的帐户名的密码。如果未更改密码，请指定 NULL 。如果服务没有密码，请指定一个空字符串。

LoadOrderGroup [in]

与新服务关联的组名称。加载顺序组包含在注册表中，并确定服务加载到操作系统中的顺序。如果指针为 NULL 或指向空字符串，则服务不属于组。组之间的依赖关系应在 LoadOrderGroupDependencies 参数中列出。首先启动负载排序组列表中的服务，然后启动不属于负载排序组列表中的组中的服务，然后启动不属于组的服务。注册表的负载排序组列表位于：

\ HKEY_LOCAL_MACHINE系统\CurrentControlSet\控制\ServiceGroupOrder

LoadOrderGroupDependencies [in]

必须在此服务之前启动的负载排序组数组。数组中的每个项都由 NULL 分隔，列表以两个 NULL 值结尾。在 Visual Basic 或脚本中，可以传递 vbArray。如果指针为 NULL 或指向空字符串，则服务没有依赖项。组名必须以 Winsvc.h 文件中定义的SC_GROUP_IDENTIFIER (为前缀) 字符，以将其与服务名称区分开来，因为服务和服务组共享相同的命名空间。依赖于某个组意味着，如果在尝试启动该组的所有成员之后至少有一个组成员正在运行，则此服务可以运行。

ServiceDependencies [in]

包含此服务启动之前必须启动的服务名称的数组。数组中的每个项都由 NULL 分隔，列表以两个 NULL 值结尾。在 Visual Basic 或脚本中，可以传递 vbArray。如果指针为 NULL，或者如果指针指向空字符串，则服务没有依赖项。对服务的依赖意味着此服务仅当它所依赖的服务正在运行时才能运行。

返回值

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

Success

已接受该请求。

不支持

不支持该请求。

拒绝访问

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

正在运行的依赖服务

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

无效的服务控制

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

服务无法接受控制

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

服务未处于活动状态

该服务尚未启动。

服务请求超时

该服务未及时响应启动请求。

未知失败

交互式进程。

找不到路径

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

服务已在运行

服务已在运行。

服务数据库已锁定

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

已删除服务依赖项

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

服务依赖项失败

该服务无法从依赖的服务中找到所需的服务。

服务已禁用

已从系统禁用该服务。

服务登录失败

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

标记为要删除的服务

正在从系统中删除此服务。

服务无线程

该服务没有执行线程。

状态循环依赖项

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

状态重复名称

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

状态名称无效

服务名称中存在无效字符。

状态无效参数

已将无效参数传递给服务。

服务帐户状态无效

运行此服务的帐户无效或缺少运行服务的权限。

状态服务存在

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

服务已暂停

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

其他

25 4294967295

要求

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

另请参阅

操作系统类
Win32_BaseService

通过

Win32_BaseService 类的 Create 方法

语法

参数

返回值

要求

另请参阅

反馈

其他资源