Метод UserControlService класса Win32_BaseService

Метод класса WMI пытается отправить определяемый пользователем код элемента управления в службу.

В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .

Синтаксис

uint32 UserControlService(
  [in] uint8 ControlCode
);

Параметры

ControlCode [in]

Значение, указывающее команду элемента управления для службы. Например, команда элемента управления — это команда "пауза" или "продолжить". Значением может быть предопределенный код или значение и действие, которые определяет служба. Ниже приведены предопределенные коды элементов управления.

SERVICE_CONTROL_CONTINUE

Уведомляет приостановленную службу о возобновлении.

SERVICE_CONTROL_INTERROGATE

Уведомляет службу о том, чтобы сообщить о текущем состоянии диспетчеру управления службами.

SERVICE_CONTROL_NETBINDADD

Уведомляет сетевую службу о наличии нового компонента для привязки.

SERVICE_CONTROL_NETBINDDISABLE

Уведомляет сетевую службу о том, что одна из ее привязок отключена.

SERVICE_CONTROL_NETBINDENABLE

Уведомляет сетевую службу о том, что отключенная привязка включена.

SERVICE_CONTROL_NETBINDREMOVE

Уведомляет сетевую службу о том, что компонент для привязки удален.

SERVICE_CONTROL_PARAMCHANGE

Уведомляет службу об изменении параметров запуска.

SERVICE_CONTROL_PAUSE

Уведомляет службу о приостановке.

SERVICE_CONTROL_STOP

Уведомляет службу о остановке.

Возвращаемое значение

Возвращает одно из значений, перечисленных в следующем списке, или другое значение, указывающее на ошибку.

Успешно

0

Запрос принят.

Не поддерживается

1

Запрос не поддерживается.

доступ запрещен

2

У пользователя нет необходимых прав доступа.

Запущенные зависимые службы

3

Службу нельзя остановить, так как от нее зависят другие работающие службы.

Недопустимый элемент управления службой

4

Запрошенный управляющий код недопустим или неприемлем для данной службы.

Служба не может принимать управление

5

Запрошенный код элемента управления не может быть отправлен в службу, так как состояние службы (Win32_BaseService. Свойство State ) равно 0, 1 или 2.

Служба не активна

6

Служба не запустилась.

Время ожидания запроса на обслуживание

7

Служба не отвечает на запрос на запуск быстро.

Неизвестный сбой

8

Интерактивный процесс.

Путь не найден

9

Путь к каталогу к исполняемому файлу службы не найден.

Служба уже запущена

10

Служба уже запущена.

База данных службы заблокирована

11

База данных для добавления новой службы заблокирована.

Удалена зависимость службы

12

Зависимость, на которую опирается эта служба, удаляется из системы.

Сбой зависимости службы

13

Служба не находит необходимую службу из зависимой службы.

Служба отключена

14

Служба отключена в системе.

Сбой входа в службу

15

Эта служба не поддерживает проверку подлинности, необходимую для работы в системе.

Служба помечена для удаления

16

Служба удаляется из системы.

Поток без службы

17

Отсутствует поток исполнения для этой службы.

Циклическая зависимость состояния

18

При запуске службы обнаружены циклические зависимости.

Повторяющееся имя состояния

19

Служба с таким именем уже запущена.

Недопустимое имя состояния

20

В имени службы есть недопустимые символы.

Недопустимый параметр status

21

В службу переданы недопустимые параметры.

Состояние недопустимой учетной записи службы

22

Учетная запись, в которой выполняется эта служба, недопустимая или не имеет разрешений на запуск службы.

Служба состояния существует

23

Служба существует в базе данных доступных в системе служб.

Служба уже приостановлена

24

Служба в данный момент приостановлена в системе.

Другое

25 4294967295

Требования

См. также раздел

Классы операционной системы

Win32_BaseService