Win32_SystemDriver 类

项目
06/12/2023

Win32_SystemDriverWMI 类表示基本服务的系统驱动程序。

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。属性和方法按字母顺序排列，而不是按 MOF 顺序排列。

语法

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

成员

Win32_SystemDriver 类具有以下类型的成员：

方法
属性

方法

Win32_SystemDriver 类具有这些方法。

方法	说明
改变	修改服务的类方法。
ChangeStartMode	修改服务的启动模式的类方法。
创建	用于创建新服务的类方法。
删除	删除现有服务的类方法。
InterrogateService	请求服务将其状态更新到服务管理器的类方法。
PauseService	尝试将服务置于暂停状态的类方法。
ResumeService	尝试将服务置于恢复状态的类方法。
StartService	尝试将服务置于其启动状态的类方法。
StopService	将服务置于已停止状态的类方法。
UserControlService	尝试将用户定义的控件代码发送到服务的类方法。

属性

Win32_SystemDriver 类具有这些属性。

AcceptPause

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_PAUSE_CONTINUE“) 、 DisplayName (”服务接受暂停“)

服务可以暂停。

此属性继承自 Win32_BaseService。

AcceptStop

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_STOP“) 、 DisplayName (”服务接受停止“)

服务可以停止。

此属性继承自 Win32_BaseService。

Caption

数据类型： 字符串
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短说明。

此属性继承自 CIM_ManagedSystemElement。

CreationClassName

数据类型： 字符串
访问类型：只读
限定符： CIM_Key、 DisplayName (“类名称”)

要显示在创建实例时使用的继承链中的第一个具体类的名称。当与类的其他键属性一起使用时，此属性允许唯一标识此类及其子类的所有实例。

此属性继承自 CIM_Service。

描述

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Description”)

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DesktopInteract

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS“) ， DisplayName (”与桌面交互“)

此服务可以在桌面上创建窗口或与窗口通信。

此属性继承自 Win32_BaseService。

DisplayName

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpDisplayName“) ， DisplayName (”显示名称“)

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

约束：接受与 Name 属性相同的值。

示例：“Atdisk”

此属性继承自 Win32_BaseService。

ErrorControl

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|dwErrorControl“) ， DisplayName (”启动失败的严重性“)

如果此服务在启动期间无法启动，则错误的严重性。此值指示启动程序在发生故障时采取的操作。所有的错误都由计算机系统记录。

此属性继承自 Win32_BaseService。

忽略 (“Ignore”)

不通知用户。

Normal (“Normal”)

通知用户。

严重 (“严重”)

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

关键 (“严重”)

系统将尝试使用正确的配置重新启动。

未知 (“未知”)

失败原因未知。

ExitCode

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwWin32ExitCode“) ， DisplayName (”Exit Code“)

定义在启动或停止服务时遇到的任何问题的 Windows 错误代码。如果错误是此类表示的服务所特有的，并且 ServiceSpecificExitCode 属性中包含该错误的相关信息，则此属性将设置为 ERROR_SERVICE_SPECIFIC_ERROR (1066)。服务在运行时将此值设置为 NO_ERROR ，并在正常终止时再次设置此值。

此属性继承自 Win32_BaseService。

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

已安装对象。此属性不需要值来指示已安装对象。

此属性继承自 CIM_ManagedSystemElement。

名称

数据类型： 字符串
访问类型：只读
限定符：键

服务的唯一标识符，用于指示所管理的功能。在对象 Description 属性中更详细地描述了此功能。

此属性继承自 CIM_Service。

PathName

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpBinaryPathName“) ， DisplayName (”文件路径名称“)

实现服务的服务二进制文件的完全限定路径。

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

此属性继承自 Win32_BaseService。

ServiceSpecificExitCode

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwServiceSpecificExitCode“) ， DisplayName (”服务器特定退出代码“)

服务启动或停止时发生的错误的特定于服务的错误代码。退出代码由此类表示的服务定义。仅当 ExitCode 属性值 为 ERROR_SERVICE_SPECIFIC_ERROR ( 1066) 时，才会设置此值。

此属性继承自 Win32_BaseService。

ServiceType

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|dwServiceType“) ， DisplayName (”Service Type“)

用于调用进程的服务的类型。

此属性继承自 Win32_BaseService。

有效值为：

内核驱动程序 (“内核驱动程序”)

文件系统驱动程序 (“文件系统驱动程序”)

适配器 (“Adapter”)

识别器驱动程序 (“识别器驱动程序”)

自己的进程 (“自己的进程”)

共享进程 (“共享进程”)

Interactive Process (“Interactive Process”)

已开始

数据类型： 布尔值
访问类型：只读
限定符： DisplayName (“Started”)

服务已启动。

此属性继承自 CIM_Service。

StartMode

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“启动模式”)

系统驱动程序的启动模式。

此属性继承自 Win32_BaseService。

启动 (“Boot”)

操作系统加载程序启动的设备驱动程序 (仅对驱动程序服务) 有效。

系统 (“系统”)

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

自动 (“自动”)

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

手动 (“手动”)

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

禁用 (“Disabled”)

无法再启动的服务。

StartName

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpServiceStartName“) ， DisplayName (”起始帐户名称“)

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

示例：“DWDOM\管理员”

此属性继承自 Win32_BaseService。

State

数据类型： 字符串
访问类型：读/写
限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwCurrentState “) ， DisplayName (”State“)

基本服务的当前状态。

此属性继承自 Win32_BaseService。

有效值为：

已停止 (“已停止”)

开始挂起 (“开始挂起”)

停止挂起 (“停止挂起”)

运行 (“正在运行”)

继续挂起 (“继续挂起”)

暂停挂起 (“暂停挂起”)

已暂停 (“暂停”)

未知 (“未知”)

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

对象的当前状态。可以定义各种操作和非操作状态。操作状态包括：“正常”、“降级”和“预失败”， (元素（例如已启用 SMART 的硬盘驱动器）可能正常运行，但预测近期) 故障。非操作状态包括：“错误”、“正在启动”、“正在停止”和“服务”。后者“服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

有效值为：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

SystemCreationClassName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_System。CreationClassName“) 、 CIM_Key、 DisplayName (”系统类名称“)

键入承载此服务的系统的名称。

此属性继承自 CIM_Service。

SystemName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_System。Name“) ， CIM_Key， DisplayName (”系统名称“)

承载此服务的系统的名称。

此属性继承自 CIM_Service。

TagId

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|dwTagId“) ， DisplayName (”Tag Id“)

组中此服务的唯一标记值。值为 0 (零) 表示尚未为服务分配标记。标记可用于对加载顺序组中的服务启动进行排序，方法是在位于以下位置的注册表中指定标记顺序向量：

此属性继承自 Win32_BaseService。

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList。

仅针对具有启动模式或系统启动模式的内核驱动程序和文件系统驱动程序启动类型服务评估标记。

备注

Win32_SystemDriver 类派生自 Win32_BaseService。

示例

列出系统驱动程序 VBScript 示例在 HTML 文件中显示已安装的系统驱动程序。

以下 PowerShell 示例从计算机上正在运行的系统驱动程序中检索大量属性。

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

要求

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

另请参阅

Win32_BaseService
操作系统类

通过

Win32_SystemDriver 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

其他资源