Метод StartService класса Win32_Service (службы удаленных рабочих столов)
Метод StartService пытается поместить указанную службу в состояние запуска.
В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.
Синтаксис
uint32 StartService();
Параметры
Этот метод не имеет параметров.
Возвращаемое значение
Возвращает одно из значений, перечисленных в следующем списке, или любое другое значение, указывающее на ошибку. Дополнительные коды ошибок см. в разделе WMI Error Constants или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.
-
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
-
Имя службы содержит недопустимые символы.
-
21
-
Службе переданы недопустимые параметры.
-
22
-
Учетная запись, под которой выполняется эта служба, является недопустимой или не имеет разрешений для запуска службы.
-
23
-
Служба существует в базе данных доступных в системе служб.
-
24
-
Служба в данный момент приостановлена в системе.
Комментарии
Хотя может показаться, что нет никакой практической разницы между остановленной и приостановленной службой, эти два состояния выглядят по-разному для SCM. Остановленная служба — это служба, которая не запущена и должна пройти всю процедуру запуска службы. Однако приостановленная служба по-прежнему работает, но ее функционирование приостановлено. Из-за этого приостановленной службе не нужно проходить всю процедуру запуска службы, но для возобновления работы требуется другая процедура.
Для запуска остановленной службы или возобновления приостановленной службы необходимо использовать соответствующий метод. Методы Win32_ServiceStartService и ResumeService следует использовать в следующих ситуациях:
- Если служба в настоящее время остановлена, ее необходимо перезапустить с помощью метода StartService . ResumeService не может запустить службу, которая в настоящее время остановлена.
- Если служба приостановлена, необходимо использовать ResumeService. Если вы используете метод StartService в приостановленной службе, вы получите сообщение "Служба уже запущена". Однако служба остается приостановленной до тех пор, пока ей не будет отправлен код управления возобновлением работы службы.
Если запустить остановленную службу, которая зависит от другой службы, будут запущены обе службы. При запуске службы с помощью этого метода все зависимые службы не запускаются автоматически. Необходимо использовать класс ассоциации Win32_DependentService и запрос Associators Of , чтобы найти зависимые элементы и запустить их отдельно.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|