Win32_SystemDriver 类的 Create 方法

项目
06/12/2023

CreateWMI 类方法创建由系统驱动程序管理的新服务。 Win32_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 (0x1)

内核驱动程序

2 (0x2)

文件系统驱动程序

4 (0x4)

适配器

8 (0x8)

识别器驱动程序

16 (0x10)

自己的进程

32 (0x20)

共享进程

256 (0x100)

交互式进程

ErrorControl [in]

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

“Ignore”

不通知用户。

"Normal"

通知用户。

“严重”

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

“Critical”

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

StartMode [in]

Windows 基本服务的启动模式。

引导

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

系统

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

自动

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

手动

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

禁用

无法再启动的服务。

DesktopInteract [in]

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

StartName [in]

运行服务的帐户名。根据服务类型，帐户名称可能采用 DomainName\Username 或用户主体名称 (UPN) 格式 (Username@DomainName) 。服务进程在运行时使用这两种形式之一进行记录。如果帐户属于内置域，则可以指定 .\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，或者如果指针指向空字符串，则服务没有依赖项。对服务的依赖意味着此服务仅当它所依赖的服务正在运行时才能运行。

返回值

如果成功创建服务，则返回值 0 (零) ;如果请求不受支持，则返回 1 (1) 值，以及指示错误的任何其他数字。

要求

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

另请参阅

操作系统类
Win32_SystemDriver

通过

Win32_SystemDriver 类的 Create 方法

语法

参数

返回值

要求

另请参阅

反馈

其他资源