Win32_BaseService 类

Win32_BaseService抽象 WMI 类表示安装在由服务控制管理器维护的注册表数据库中的可执行对象。 与服务关联的可执行文件可以在启动时由启动程序或系统启动。 服务控制管理器也可以按需启动它。 任何非特定用户拥有且提供计算机系统支持的某些功能的接口的服务或进程都是此类的后代 (或成员) 。

示例：运行 Windows Server 的计算机系统上 (DHCP) 客户端服务的动态主机配置协议。

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

语法

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  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_BaseService 类具有以下类型的成员：

• 方法
• 属性

方法

Win32_BaseService 类具有这些方法。

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

属性

Win32_BaseService 类具有这些属性。

AcceptPause

数据类型： 布尔值

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_PAUSE_CONTINUE“) ， DisplayName (”Service 接受暂停“)

服务可以暂停。

AcceptStop

数据类型： 布尔值

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_STOP“) ， DisplayName (”Service 接受停止“)

服务可以停止。

Caption

数据类型： string

访问类型：只读

限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短说明。

此属性继承自 CIM_ManagedSystemElement。

CreationClassName

数据类型： string

访问类型：只读

限定符： CIM_Key、 DisplayName (“Class Name”)

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

此属性继承自 CIM_Service。

描述

数据类型： string

访问类型：只读

限定符： DisplayName (“Description”)

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DesktopInteract

数据类型： 布尔值

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS“) ， DisplayName (”与桌面交互“)

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

DisplayName

数据类型： string

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpDisplayName“) ， DisplayName (”显示名称“)

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

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

示例：“Atdisk”

ErrorControl

数据类型： string

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|dwErrorControl“) ， DisplayName (”启动失败的严重性“)

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

忽略 (“Ignore”)

不通知用户。

Normal (“Normal”)

通知用户。

严重 (“严重”)

系统已使用上次已知良好的配置重启。

关键 (“严重”)

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

未知 (“未知”)

未指定执行的操作。

ExitCode

数据类型： uint32

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwWin32ExitCode“) ， DisplayName (”Exit Code“)

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

InstallDate

数据类型： datetime

访问类型：只读

限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

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

此属性继承自 CIM_ManagedSystemElement。

名称

数据类型： string

访问类型：只读

限定符： 键

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

此属性继承自 CIM_ManagedSystemElement。

PathName

数据类型： string

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpBinaryPathName“) ， DisplayName (”File Path Name“)

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

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

ServiceSpecificExitCode

数据类型： uint32

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwServiceSpecificExitCode“) ， DisplayName (”服务器特定的退出代码“)

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

ServiceType

数据类型： string

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|dwServiceType“) ， DisplayName (”Service Type“)

提供给调用进程的服务。

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

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

适配器 (“Adapter”)

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

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

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

Interactive Process (“Interactive Process”)

已开始

数据类型： 布尔值

访问类型：只读

限定符： DisplayName (“Started”)

服务已启动。

此属性继承自 CIM_Service。

StartMode

数据类型： string

访问类型：只读

限定符： 替代 (“StartMode”) ， DisplayName (“Start Mode”)

Windows 基本服务的启动模式。

此属性继承自 CIM_Service。

启动 (“启动”)

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

系统 (“系统”)

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

自动 (“自动”)

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

手动 (“手动”)

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

disabled (“Disabled”)

无法再启动的服务。

StartName

数据类型： string

访问类型：只读

限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpServiceStartName“) ， DisplayName (”Starting Account Name“)

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

State

数据类型： string

访问类型：读/写

限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwCurrentState “) ， DisplayName (”State“)

基本服务的当前状态。

已停止 (“已停止”)

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

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

运行 (“正在运行”)

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

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

已暂停 (“已暂停”)

未知 (“未知”)

Windows Server 2008 和 Windows Vista： 此属性为只读。

Status

数据类型： string

访问类型：只读

限定符： 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 (零) 表示尚未为服务分配标记。 标记可用于对加载顺序组中的服务star tup 进行排序，方法是在位于 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList 的注册表中指定标记顺序向量。 仅针对具有启动模式或系统启动模式的内核驱动程序和文件系统驱动程序启动类型服务评估标记。

备注

Win32_BaseService 类派生自 CIM_Service。

要求

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

另请参阅

CIM_Service

操作系统类