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 -> unitProtected Overridable Sub OnCustomCommand (command As Integer)Параметры
- command
- Int32
Сообщение команды, отправленное службе.
Комментарии
OnCustomCommand позволяет указать дополнительные функциональные возможности, помимо запуска, остановки, приостановки и продолжения служб.
SCM не проверяет пользовательскую команду, чтобы проверить, поддерживает ли служба переданный command параметр. Она передает пользовательскую команду непосредственно в службу. Если служба не распознает command параметр, он ничего не делает.
Пользовательские команды вызываются ExecuteCommand инструкцией в компоненте ServiceController . Используйте инструкцию switch или if.. затем условие для обработки пользовательских команд, которые вы определяете в службе.
Единственными значениями для пользовательской команды, которую можно определить в приложении или использовать, OnCustomCommand являются значения от 128 до 255. Целые числа ниже 128 соответствуют системным зарезервированным значениям.
AutoLog Если свойство имеет trueзначение , пользовательские команды, как и все другие команды, записывают записи в журнал событий, чтобы сообщить о успешном выполнении метода или сбое.
