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 -> unitProtected Overridable Sub OnCustomCommand (command As Integer)パラメーター
- command
- Int32
サービスに送信されたコマンド メッセージ。
注釈
OnCustomCommand では、サービスの開始、停止、一時停止、継続以外の機能を指定できます。
SCM は、カスタム コマンドを調べて、渡されたパラメーターがサービスで command サポートされているかどうかを確認しません。 カスタム コマンドをサービスに直接渡します。 サービスがパラメーターを command 認識しない場合、何も行われません。
カスタム コマンドは、コンポーネント内ServiceControllerのExecuteCommandステートメントによって発生します。 switch ステートメントまたは if.. を使用します。次に、サービスで定義したカスタム コマンドを処理するように条件を設定します。
アプリケーションで定義または使用 OnCustomCommand できるカスタム コマンドの値は、128 から 255 までの値のみです。 128 未満の整数は、システム予約値に対応します。
プロパティが AutoLog カスタム コマンドの場合は true、他のすべてのコマンドと同様に、イベント ログにエントリを書き込み、メソッドの実行が成功したか失敗したかを報告します。