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

Функция OpenService.

Функция OpenService открывает существующий сервис.

 

SC_HANDLE OpenService(
  SC_HANDLE hSCManager,
  LPCTSTR lpServiceName,
  DWORD dwDesiredAccess
);

Параметры

hSCManager
Дескриптор базы данных менеджера управления сервисами. Этот дескриптор можно получить при помощи функции OpenSCManager.
lpServiceName
Указатель на строку (заканчивающуюся нулевым символом), содержащую имя открываемого сервиса. Длина строки не должна превышать 256 символов.
dwDesiredAccess
Тип доступа к сервису. См. Безопасность сервисов и типы доступа.

Перед тем, как разрешить доступ к сервису, система проверяет права процесса, из которого пришёл запрос.

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

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

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

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

 

Значение Описание
ERROR_ACCESS_DENIED Дескриптор не емеет достаточных прав для доступа к сервису.
ERROR_INVALID_HANDLE Указан неправильный дескриптор.
ERROR_INVALID_NAME Указано неправильное имя сервиса.
ERROR_SERVICE_DOES_NOT_EXIST Указанный сервис не существует.


Замечания

Полученный дескриптор будет действовать только для того процесса, который вызвал OpenService. Закрыть дескриптор можно при помощи функции CloseServiceHandle.

Пример

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

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

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