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