Поделиться через

Функция ResUtilStartResourceService (resapi.h)

  • Статья

Запускает службу. Тип PRESUTIL_START_RESOURCE_SERVICE определяет указатель на эту функцию.

Синтаксис

DWORD ResUtilStartResourceService(
  [in]  LPCWSTR     pszServiceName,
  [out] LPSC_HANDLE phServiceHandle
);

Параметры

[in] pszServiceName

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

[out] phServiceHandle

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

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

Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.

Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведен возможный код ошибки.

Код возврата Описание
ERROR_SERVICE_NEVER_STARTED
 Служба не запущена.

Комментарии

Служебная функция ResUtilStartResourceService инкапсулирует необходимые вызовы диспетчера управления службами, предоставляя удобный способ запуска служб в кластере. Использование ResUtilStartResourceService является необязательным. Если для запуска службы требуются определенные ограничения доступа или другая специальная обработка, используйте вместо нее функции диспетчера управления службами.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Целевая платформа Windows
Header resapi.h
Библиотека ResUtils.lib
DLL ResUtils.dll

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

ResUtilStopService