ServiceController.ExecuteCommand メソッド

.NET Framework クラス ライブラリ リファレンス

ServiceController.ExecuteCommand メソッド

サービスでカスタム コマンドを実行します。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Sub ExecuteCommand ( _
    command As Integer _
)

Visual Basic (使用法)

Dim instance As ServiceController
Dim command As Integer

instance.ExecuteCommand(command)

C#

public void ExecuteCommand (
    int command
)

C++

public:
void ExecuteCommand (
    int command
)

J#

public void ExecuteCommand (
    int command
)

JScript

public function ExecuteCommand (
    command : int
)

パラメータ

command

実行するカスタム コマンドを示す、アプリケーション定義のコマンド フラグ。

例外

例外の種類	条件
Win32Exception	システム API へのアクセス中にエラーが発生しました。
InvalidOperationException	サービスがカスタム コマンドを処理できません。

解説

ExecuteCommand を呼び出すと、サービスのステータスは変更しません。サービスが開始されていた場合、ステータスは Running のままです。サービスが停止されていた場合、ステータスは Stopped のままです。カスタム コマンドを処理するには、サービスは OnCustomCommand メソッドをオーバーライドし、command パラメータで識別されるコマンドのハンドラを提供する必要があります。

.NET Framework のセキュリティ

• ServiceControllerPermission  (コンピュータ上のサービスを制御するために必要な許可)。ServiceControllerPermissionAccess.Control (関連する列挙体)
• SecurityPermission  (サービス情報に無制限アクセスするために必要な許可)。PermissionState.Unrestricted (関連する列挙体)
• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceController クラス
ServiceController メンバ
System.ServiceProcess 名前空間
OnCustomCommand