次の方法で共有


ServiceBase.OnCustomCommand(Int32) メソッド

定義

派生クラスに実装されると、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)

パラメーター

command
Int32

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

注釈

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

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

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

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

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

適用対象

こちらもご覧ください