Функция ResUtilSetResourceServiceStartParametersEx (resapi.h)
Корректирует параметры запуска указанной службы , чтобы она правильно работала как ресурс кластера. Он должен вызываться из библиотеки DLL ресурса. Тип PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX определяет указатель на эту функцию.
Синтаксис
DWORD ResUtilSetResourceServiceStartParametersEx(
[in] LPCWSTR pszServiceName,
[in] SC_HANDLE schSCMHandle,
[in, out] LPSC_HANDLE phService,
[in] DWORD dwDesiredAccess,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
Параметры
[in] pszServiceName
Указатель на строку Юникода, завершающуюся null, которая указывает имя службы.
[in] schSCMHandle
Дескриптор диспетчера управления службами (SCM) или null. Если значение РАВНО NULL, функция пытается открыть дескриптор для SCM.
[in, out] phService
На входных данных — дескриптор службы NULL . В выходных данных обработайте указанную службу, если вызов был успешным; в противном случае — NULL.
[in] dwDesiredAccess
Запрошенные привилегии доступа. Это может быть любое сочетание GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) или MAXIMUM_ALLOWED (0x02000000). Если это значение равно нулю (0), может быть возвращена неопределенная ошибка. Использование GENERIC_ALL аналогично вызову ResUtilSetResourceServiceStartParameters.
[in] pfnLogEvent
Указатель на функцию точки входа LogEvent библиотеки DLL ресурса, которая управляет службой.
[in] hResourceHandle
Дескриптор ресурса, необходимый для функции точки входа LogEvent . Используйте дескриптор, который передается в библиотеку DLL в функции Открыть точку входа.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.
Если операция завершается сбоем, функция возвращает код системной ошибки.
Комментарии
ResUtilSetResourceServiceStartParametersEx проверяет, не отключена ли служба, изменяет конфигурацию службы на ручной запуск и предотвращает перезапуск службы в ответ на сбой. Это позволяет кластеру и библиотеке DLL ресурсов управлять службой.
Если библиотека DLL ресурса управляет службой, используйте ResUtilSetResourceServiceStartParametersEx и ResUtilSetResourceServiceEnvironment , прежде чем перевести службу в режим "в сети".
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Ни одна версия не поддерживается |
Минимальная версия сервера | Windows Server 2012 |
Целевая платформа | Windows |
Header | resapi.h |
Библиотека | ResUtils.lib |
DLL | ResUtils.dll |