Win32_Service 类的 PauseService 方法 (CIMWin32 WMI 提供程序)

  • 项目

PauseServiceWMI 类方法尝试将服务置于暂停状态。

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

语法

uint32 PauseService();

参数

此方法没有任何参数。

返回值

返回以下列表中列出的值之一，或指示错误的任何其他值。 有关其他错误代码，请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值，请参阅 系统错误代码。

0

已接受该请求。

1

不支持该请求。

2

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

3

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

4

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

5

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

6

该服务尚未启动。

7

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

8

启动服务时出现未知失败。

9

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

10

服务已在运行。

11

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

12

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

13

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

14

已从系统禁用该服务。

15

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

16

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

17

服务没有执行线程。

18

服务启动时具有循环依赖项。

19

服务以同一名称运行。

20

服务名称包含无效字符。

21

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

22

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

23

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

24

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

备注

确定可以停止或暂停哪些服务后，可以使用 StopService 和 PauseService 方法来停止和暂停服务。 停止服务而不是暂停服务的决定取决于几个因素，包括以下内容：

  • 服务是否能够暂停？ 否则，唯一的选择是停止服务。
  • 是否需要继续处理已连接到该服务的任何人的客户端请求？ 如果是这样，暂停服务通常允许它处理现有客户端，同时拒绝访问新客户端。 相比之下，停止服务时，所有客户端都会立即断开连接。
  • 是否需要重新配置服务并让更改立即生效？ 尽管服务属性可以在服务暂停时更改，但大多数属性在服务实际停止和重启之前不会生效。

停止服务所需的脚本代码与暂停服务所需的代码几乎完全相同。

示例

暂停在特定帐户 VBScript 下运行的服务示例暂停在假设服务帐户“Netsvc”下运行的所有服务。

以下 VBScript 代码示例演示如何从 Win32_Service 实例暂停特定服务。

注意

该服务必须支持暂停并已在运行。

Set ServiceSet = GetObject("winmgmts:").ExecQuery("select * from Win32_Service where Name='Schedule'")

for each Service in ServiceSet
 SupportsPause = Service.AcceptPause
 if SupportsPause = true then
  RetVal = Service.PauseService()
  if RetVal = 0 then 
   WScript.Echo "Service paused"   
  else
   if RetVal = 1 then 
    WScript.Echo "Pause not supported" 
   else WScript.Echo "An error occurred:" & RetVal
   End If
  End If
 else
  WScript.Echo "Service does not support pause"
 end if
next

以下 Perl 代码示例演示如何从 Win32_Service 实例暂停特定服务。

注意

该服务必须支持暂停并已在运行。

use strict;
use Win32::OLE;

my ($ServiceSet, $SupportsPause, $RetVal);  
eval {$ServiceSet = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\Root\\CIMv2")->
 ExecQuery("SELECT * FROM Win32_Service WHERE Name='Schedule'"); };
unless($@)
{
 foreach my $ServiceInst (in $ServiceSet)
 {
  if ($ServiceInst->{AcceptPause})
  {
   $RetVal = $ServiceInst->PauseService();
   if ($RetVal == 0)
   {
    print "\nService paused\n";
   }
   else
   {
    if ($RetVal == 1)
    {
     print "\nPause not supported\n" ;
    }
    else 
    {
     print "\nAn error occurred:", $RetVal, "\n";
    }
   } 
  }
  else
  {
   print "\nService does not support pause\n";
  }
 }
}
else
{
 print STDERR "\n", Win32::OLE->LastError, "\n";
}

要求

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

另请参阅

操作系统类

Win32_Service

WMI 任务：服务

StopService