Функция StartService / Сервисы NT / Система. Общее

Функция StartService.

Функция StartService запускает сервис.

BOOL StartService(
  SC_HANDLE hService,
  DWORD dwNumServiceArgs,
  LPCTSTR* lpServiceArgVectors
);

Параметры

hService: Дескриптор сервиса. Этот дескриптор возвращают функции OpenService или CreateService и он должен иметь режим доступа SERVICE_START. Более подробно см. Безопасность сервисов и права доступа.
dwNumServiceArgs: Количество строк в массиве lpServiceArgVectors. Если lpServiceArgVectors равен NULL, то этот параметр может быть нулевым.
lpServiceArgVectors: Указатель на массив указателей на строки (завершающиеся нулём), которые будут переданы в сервис как аргументы. Сервисы драйверов не получают этих аргументов. Если сервису не передаются никакие параметры, то этот параметр можно задать как NULL. Сервис получает доступ к этим аргументам через свою функцию ServiceMain. Первый аргумент (argv[0]), это имя сервиса.

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

В случае успеха, функция возвращает ненулевое значение.

В случае ошибки, функция вернёт ноль. Для получения более подробной информации об ошибке, можно воспользоваться функцией GetLastError.

В таблице представлены стандартные коды ошибок:

Значение	Описание
ERROR_ACCESS_DENIED	Дескриптор не имеет прав на запуск сервиса.
ERROR_INVALID_HANDLE	Неправильный дескриптор.
ERROR_PATH_NOT_FOUND	Не найден исполняемый файл сервиса.
ERROR_SERVICE_ALREADY_RUNNING	Экземпляр сервиса уже запущен.
ERROR_SERVICE_DATABASE_LOCKED	база данных заблокирована.
ERROR_SERVICE_DEPENDENCY_DELETED	Сервис зависит от другого сервиса, который не существует или помечен на удаление.
ERROR_SERVICE_DEPENDENCY_FAIL	Сервис зависит от другого сервиса, который не получается запустить.
ERROR_SERVICE_DISABLED	Запуск сервиса запрещён.
ERROR_SERVICE_LOGON_FAILED	Эта ошибка появляется, если сервис был запущен и аккаунта, который не имеет прав "Log on as a service".
ERROR_SERVICE_MARKED_FOR_DELETE	Сервис был помечен на удаление.
ERROR_SERVICE_NO_THREAD	Не удаётся создать поток для сервиса.
ERROR_SERVICE_REQUEST_TIMEOUT	Процесс для сервиса был создан, но он не вызвал функцию StartServiceCtrlDispatcher, или поток, который вызвал StartServiceCtrlDispatcher мог быть быть блокирован в функции обработчика.

Замечания

При запуске сервисов драйверов, функция StartService не вернёт управление до тех пор, пока драйвер устройства не закончит инициализацию.

Перед тем, как вернуть управление из StartService, менеджер управления сервисами устанавливает следующие значения состояния сервиса:

Текущее состояние сервиса SERVICE_START_PENDING.
Controls accepted is set to none (zero).
Значение CheckPoint устанавливается в ноль.
Время WaitHint устанавливается в 2 секунды.

Чтобы контролировать процесс запуска сервиса, можно периодически вызывать функцию QueryServiceStatus.

В процессе инициализации, сервис не может вызывать StartService, так как на время инициализации сервиса, менеджер блокирует базу данных.

Пример

См. Запуск сервиса.

Дополнительная информация

Windows NT/2000/XP: Присутствует начиная с Windows NT 3.1 и выше.
Unicode: Существует как Unicode, так и ANSI версии.
Заголовок: Объявлена в Winsvc.h; включена в Windows.h.
Библиотека: Advapi32.lib.