ServiceBase.OnCustomCommand(Int32) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

派生クラスに実装されると、OnCustomCommand(Int32) は、サービスコントロールマネージャー (SCM) でカスタムコマンドがサービスに渡されるときに、実行されます。パラメーター値が設定されているコマンドの発生時に実行されるアクションを指定します。

protected:
 virtual void OnCustomCommand(int command);

protected virtual void OnCustomCommand (int command);

abstract member OnCustomCommand : int -> unit
override this.OnCustomCommand : int -> unit

Protected Overridable Sub OnCustomCommand (command As Integer)

サービスに送信されたコマンドメッセージ。

OnCustomCommand では、サービスの開始、停止、一時停止、継続以外の機能を指定できます。

SCM は、カスタムコマンドを調べて、渡されたパラメーターがサービスで command サポートされているかどうかを確認しません。カスタムコマンドをサービスに直接渡します。サービスがパラメーターを command 認識しない場合、何も行われません。

カスタムコマンドは、コンポーネント内ServiceControllerのExecuteCommandステートメントによって発生します。 switch ステートメントまたは if.. を使用します。次に、サービスで定義したカスタムコマンドを処理するように条件を設定します。

アプリケーションで定義または使用 OnCustomCommand できるカスタムコマンドの値は、128 から 255 までの値のみです。 128 未満の整数は、システム予約値に対応します。

プロパティが AutoLog カスタムコマンドの場合は true、他のすべてのコマンドと同様に、イベントログにエントリを書き込み、メソッドの実行が成功したか失敗したかを報告します。

製品	バージョン
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8