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 参数，则它不执行任何作用。

自定义命令由 ExecuteCommand 组件中的 ServiceController 语句引发。使用 switch 语句或 if.。然后条件来处理在服务上定义的自定义命令。

可在应用程序中 OnCustomCommand 定义的自定义命令的唯一值是 128 到 255 之间的值。低于 128 的整数对应于系统保留的值。

AutoLog如果该属性是true自定义命令（与所有其他命令一样）将条目写入事件日志，以报告方法执行成功还是失败。