"AND" "OR"
Главная Информер Журнал Форум

Функция 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.