Win32_BaseService クラスの UserControlService メソッド

WMI クラス メソッドは、ユーザー定義の制御コードをサービスに送信しようとします。

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

構文

uint32 UserControlService(
  [in] uint8 ControlCode
);

パラメーター

ControlCode [in]

サービスに対する制御コマンドを指定する値。 たとえば、コントロール コマンドは "一時停止" または "続行" コマンドです。 値には、定義済みのコード、またはサービスが定義する値とアクションを指定できます。 定義済みのコントロール コードを次に示します。

SERVICE_CONTROL_CONTINUE

一時停止中のサービスに再開を通知します。

SERVICE_CONTROL_INTERROGATE

サービス コントロール マネージャーに現在の状態情報を報告するようにサービスに通知します。

SERVICE_CONTROL_NETBINDADD

バインド用の新しいコンポーネントがあることをネットワーク サービスに通知します。

SERVICE_CONTROL_NETBINDDISABLE

いずれかのバインディングが無効になっていることをネットワーク サービスに通知します。

SERVICE_CONTROL_NETBINDENABLE

無効なバインディングが有効になっていることをネットワーク サービスに通知します。

SERVICE_CONTROL_NETBINDREMOVE

バインド用のコンポーネントが削除されたことをネットワーク サービスに通知します。

SERVICE_CONTROL_PARAMCHANGE

スタートアップ パラメーターが変更されたことをサービスに通知します。

SERVICE_CONTROL_PAUSE

サービスに一時停止を通知します。

SERVICE_CONTROL_STOP

停止するようにサービスに通知します。

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示す別の値を返します。

Success

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

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

Status Service Exists

23

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

サービスは既に一時停止しています

24

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

その他

25 4294967295

要件

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

こちらもご覧ください

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

Win32_BaseService