ServiceBase.OnCustomCommand(Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Если метод OnCustomCommand(Int32) реализован в производном классе, он выполняется при передаче службе пользовательской команды диспетчером служб. Задает действия, подлежащие выполнению при появлении команды с указанным значением параметра.
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 параметр, он ничего не делает.
Пользовательские команды вызываются инструкцией ExecuteCommand в компоненте ServiceController . Используйте оператор switch или if.. затем условие для обработки пользовательских команд, которые вы определяете в службе.
Единственными значениями для пользовательской команды, которую можно определить в приложении или использовать, OnCustomCommand являются значения от 128 до 255. Целые числа ниже 128 соответствуют системным зарезервированным значениям.
AutoLog Если свойство имеет значение true, пользовательские команды, как и все остальные команды, записывают записи в журнал событий, чтобы сообщить, успешно ли выполнено или завершилось сбой выполнения метода.