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

Статья
06/12/2023

Метод класса 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: Уведомляет службу о остановке.

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

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

Успешно

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Другое

25 4294967295

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

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

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

Share via