Win32_Service クラスの Delete メソッド (リモート デスクトップ サービス)

  • [アーティクル]

DeleteWMI クラス メソッドは、既存のサービスを削除します。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 Delete();

パラメーター

このメソッドにはパラメーターはありません。

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示すその他の値を返します。 その他のエラー コードについては、「 WMI エラー定数」 または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

0

要求が受け入れられました。

1

要求はサポートされていません。

2

ユーザーに必要なアクセス権がありませんでした。

3

そのサービスは、実行中の他のサービスが依存しているので停止できません。

4

要求された制御コードは有効でないか、またはサービスを受け入れ可能ではありません。

5

サービスの状態 (Win32_BaseServiceのため、要求された制御コードをサービスに送信できません。State プロパティ) は、0、1、または 2 と等しくなります。

6

サービスは開始されていません。

7

サービスは適切な時間内に開始要求に応答しませんでした。

8

サービスの開始時に不明なエラーが発生しました。

9

サービス実行可能ファイルへのディレクトリ パスが見つかりませんでした。

"10"

サービスは既に実行されています。

11

新しいサービスを追加するデータベースはロックされています。

12

このサービスが依存する依存関係がシステムから削除されました。

13

サービスは依存関係のあるサービスから必要なサービスを見つけられませんでした。

14

サービスはシステムから無効になっています。

15

サービスにはシステムで実行するための正しい認証がありません。

16

このサービスはシステムから削除されています。

17

サービスに実行スレッドがありません。

18

サービスは起動時に循環依存関係を持ちます。

19

サービスは同じ名前で実行されています。

20

サービス名に無効な文字が含まれています。

21

無効なパラメーターがサービスに渡されました。

22

このサービスを実行するアカウントが無効であるか、サービスを実行するためのアクセス許可がありません。

23

サービスは、システムから利用できるサービスのデータベースにあります。

24

サービスは現在システムで一時停止されています。

解説

organizationが変更されると、特定のコンピューターから特定のサービスを削除する場合があります。 社内およびサードパーティのサービスは WMI を使用して削除できますが、オペレーティング システム サービスは Sysocmgr.exe を使用して削除できます。

サービスを削除する準備をするときは、次の情報に注意してください。

  • サービスを削除する前に、サービスを停止する必要があります。 delete コマンドを発行するときにサービスが実行されている場合、サービスは削除のマークが付けられますが、停止して開いているすべてのハンドルが閉じられるまで、サービスは引き続き実行されます。

    サービスが停止しない場合、そのサービスは削除されません。

  • サービスを削除しても、サービスの実行可能ファイルは削除されません。

    WMI を使用してサービスを削除すると、HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Servicesの関連するレジストリ エントリが削除されます。 その結果、サービスはインストールされなくなり、サービス スナップインでは使用できません。 ただし、WMI は実行可能ファイルを削除しないため、サービスを簡単に再インストールできます。 実行可能ファイルを削除するには、パス名を取得してからファイルを削除する必要があります。

  • WMI を使用して基本 Windows 2000 サービス (DHCP など) を削除すると、そのサービスのレジストリ エントリが削除されますが、[管理ツール] メニューからショートカットが削除されたり、Windows コンポーネント ウィザードからサービスが削除されたりすることはありません。 これにより、コンピューターの構成方法を判断しようとしているすべてのユーザーが混乱する可能性があります。

    たとえば、WMI スクリプトを使用して DHCP サービスを削除すると、DHCP サービスはサービス スナップインに表示されなくなります。 ただし、DHCP コンソールへの機能しないショートカットは [管理ツール] メニューに残り、Windows コンポーネント ウィザードを起動すると、DHCP サービスがインストールされていることを示します。

    このため、プログラムによって Windows 2000 サービスを削除するには、常に Sysocmgr.exe を使用する必要があります。

例

次の VBScript コード サンプルでは、サービスを削除する方法について説明します。

strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
 & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colListOfServices = objWMIService.ExecQuery _
 ("SELECT * FROM Win32_Service WHERE Name = 'DbService'")
For Each objService in colListOfServices
 objService.StopService()
 objService.Delete()
Next

次の Perl コード サンプルでは、サービスを削除する方法について説明します。

use strict;
use Win32::OLE;

my ($Service, $ServiceSet) ;
eval {$ServiceSet = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}")->
 ExecQuery("SELECT * FROM Win32_Service WHERE Name='MyService'");};
unless($@)
{
 foreach $Service (in $ServiceSet)
 {
  my $RetVal = $Service->Delete();
  if ($RetVal == 0)  
  {
   print "Service deleted \n"; 
  }
  else  
  {
   print "Delete failed: %d", $RetVal;
  }
 }
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
名前空間
 Root\CIMv2\TerminalServices
MOF
TSCfgWmi.mof
[DLL]
TSCfgWmi.dll

関連項目

Win32_Service

オペレーティング システム クラス

Win32_TerminalService

WMI タスク: サービス