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


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

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

ResUtilSetResourceServiceStartParameters

Служебные функции службы