Win32_TerminalService 类

项目
06/12/2023

Win32_TerminalService WMI 类是 Win32_Service 类的子类。 Win32_TerminalService表示Win32_TerminalServiceToSetting关联的 Element 属性。

以下语法在 MOF 代码中进行了简化，包括所有已定义和继承的属性（按字母顺序排列）。

语法

[dynamic, provider("Win32_WIN32_TERMINALSERVICE_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalService : Win32_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  uint32   CheckPoint;
  string   CreationClassName;
  boolean  DelayedAutoStart;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ProcessId;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
  uint32   WaitHint;
  uint32   DisconnectedSessions;
  uint32   TotalSessions;
};

成员

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

方法
属性

方法

Win32_TerminalService 类具有这些方法。

方法	说明
改变	修改服务。
ChangeStartMode	修改服务的启动模式。
创建	创建一项新服务。
删除	删除现有服务。
GetSecurityDescriptor	返回控制对服务的访问权限的安全描述符。
InterrogateService	请求服务将其状态更新到服务管理器。
PauseService	尝试将服务置于暂停状态。
ResumeService	尝试将服务置于恢复状态。
SetSecurityDescriptor	编写用于控制对服务的访问权限的安全描述符的更新版本。
StartService	尝试将服务置于启动状态。
StopService	将服务置于已停止状态。
UserControlService	尝试将用户定义的控件代码发送到服务。

属性

Win32_TerminalService 类具有以下属性。

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。

检查站

数据类型： uint32
访问类型：只读
限定符：MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwCheckPoint“) ， DisplayName (”Check Point Count“)

服务定期递增以在长时间启动、停止、暂停或继续操作期间报告其进度的值。例如，服务在启动时完成初始化的每个步骤时递增此值。在服务上调用操作的用户界面程序使用此值跟踪服务在长时间操作期间的进度。此值无效，当服务没有挂起的启动、停止、暂停或继续操作时，此值应为零。

此属性继承自 Win32_Service。

CreationClassName

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

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

此属性继承自 CIM_Service。

DelayedAutoStart

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |SERVICE_DELAYED_AUTO_START_INFO|fDelayedAutostart“) ， DisplayName (”延迟自动启动“)

如果 为 True，则服务在启动其他自动启动服务后启动，加上短暂的延迟。

Windows Server 2012 R2、Windows 8.1、Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：在Windows Server 2016和Windows 10之前不支持此属性.

此属性继承自 Win32_Service。

描述

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

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DesktopInteract

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

指示服务是否可以在桌面上创建窗口或与 Windows 通信，从而以某种方式与用户交互。交互式服务必须在本地系统帐户下运行。大多数服务不是交互式服务：也就是说，他们不会以任何方式与用户通信。

此属性继承自 Win32_BaseService。

DisconnectedSessions

数据类型： uint32
访问类型：只读

当前服务器上断开连接的会话数。这些会话可能仍在主动消耗服务器资源，但它们当前没有与客户端的网络连接。

DisplayName

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

在“服务”管理单元中查看的服务的名称。此字符串的最大长度为 256 个字符。请注意，存储在注册表) 中的显示名称和服务名称 (并不总是相同的。例如，DHCP 客户端服务的服务名称为 Dhcp，但显示名称为 DHCP 客户端。名称在服务控制管理器中保留大小写。但是， DisplayName 比较始终不区分大小写。

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

示例：“Atdisk”

此属性继承自 Win32_BaseService。

ErrorControl

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

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

忽略 (“Ignore”)

不通知用户。

Normal (“Normal”)

通知用户。通常，这是一个消息框显示，通知用户有问题。

严重 (“严重”)

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

关键 (“严重”)

系统将尝试使用正确的配置重新启动。如果服务第二次无法启动，则启动将失败。

未知 (“未知”)

错误的严重性未知。

此属性继承自 Win32_BaseService。

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。

名称

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

服务的唯一标识符，用于指示所管理的功能。对象的 Description 属性中介绍了此功能。

此属性继承自 CIM_ManagedSystemElement。

PathName

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpBinaryPathName“) ， DisplayName (”File Path Name“)

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

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

此属性继承自 Win32_BaseService。

ProcessId

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

服务的进程标识符。

示例：324

此属性继承自 Win32_Service。

ServiceSpecificExitCode

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

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

此属性继承自 Win32_BaseService。

ServiceType

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

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

有效值为：

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

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

适配器 (“Adapter”)

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

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

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

Interactive Process (“Interactive Process”)

此属性继承自 Win32_BaseService。

已开始

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

指示服务是否已启动。

此属性继承自 CIM_Service。

StartMode

数据类型： string
访问类型：只读
限定符： DisplayName (“Start Mode”)

Windows 基本服务的启动模式。

启动 (“启动”)

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

系统 (“系统”)

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

自动 (“自动”)

服务将在系统启动期间由服务控制管理器自动启动。即使用户未登录，也会启动自动服务。

手动 (“手动”)

当进程调用 StartService 方法时，由服务控制管理器启动的服务。除非用户登录并启动这些服务，否则这些服务不会启动。

disabled (“Disabled”)

在 StartMode 更改为“自动”或“手动”之前无法启动的服务。

此属性继承自 CIM_Service。

StartName

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |QUERY_SERVICE_CONFIG|lpServiceStartName“) ， DisplayName (”Starting Account Name“)

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

示例：“DWDOM\管理员”

此属性继承自 Win32_BaseService。

State

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

基本服务的当前状态。

有效值为：

已停止 (“已停止”)

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

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

运行 (“正在运行”)

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

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

已暂停 (“已暂停”)

未知 (“未知”)

Windows Server 2008 和 Windows Vista： 此属性在 Windows 7 和 Windows Server 2008 R2 之前是只读的。

此属性继承自 Win32_BaseService。

Status

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

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

有效值为：

OK (“OK”)

错误 (“错误”)

已降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

正在启动 (“正在启动”)

正在停止 (“停止”)

服务 (“Service”)

压力 (“有压力”)

NonRecover (“NonRecover”)

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

Lost Comm (“Lost Comm”)

此属性继承自 CIM_ManagedSystemElement。

SystemCreationClassName

数据类型： string
访问类型：只读
限定符：传播 (“CIM_System。CreationClassName“) ， CIM_Key， DisplayName (”System Class Name“)

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

此属性继承自 CIM_Service。

SystemName

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

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

此属性继承自 CIM_Service。

TagId

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

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

\ HKEY_LOCAL_MACHINE系统\CurrentControlSet\控制\ GroupOrderList

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

此属性继承自 Win32_BaseService。

TotalSessions

数据类型： uint32
访问类型：只读

当前服务器上的会话总数。这包括已连接和断开连接的会话。

WaitHint

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|服务结构 |SERVICE_STATUS|dwWaitHint“) ， DisplayName (”估计等待时间“)

挂起的开始、停止、暂停或继续操作所需的估计时间（以毫秒为单位）。指定时间过后，服务使用递增的 CheckPoint 值或 CurrentState 中的更改对 SetServiceStatus 方法进行下一次调用。如果 WaitHint 指定的时间经过，并且 CheckPoint 未递增，或者 CurrentState 未更改，则服务控制管理器或服务控制程序假定发生了错误。

此属性继承自 Win32_Service。

备注

由于 Win32_TerminalService 类是 Win32_Service 类的子类，因此该类继承 Win32_Service的所有属性和方法。

Win32_TerminalServiceSetting 作为 Win32_TerminalServiceToSetting 关联的 Setting 属性与 Win32_TerminalService 相关联。

Win32_TSSessionDirectory 作为 Win32_TSSessionDirectorySetting 关联的 Setting 属性与 Win32_TerminalService 相关联。

托管对象格式 (MOF) 文件包含 Windows Management Instrumentation (WMI) 类的定义。 MOF 文件未作为 Microsoft Windows 软件开发工具包 (SDK) 的一部分安装。使用服务器管理器添加关联角色时，这些角色将安装在服务器上。有关 MOF 文件的详细信息，请参阅托管对象格式 (MOF) 。

要求

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

另请参阅

Win32_Service
Win32_TerminalServiceToSetting
Win32_TSSessionDirectory
Win32_BaseService
CIM_Service

通过

Win32_TerminalService 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源