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 结尾的 Unicode 字符串的指针,该字符串指定服务的名称。
[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
指向管理服务的资源 DLL 的 LogEvent 入口点函数的指针。
[in] hResourceHandle
LogEvent 入口点函数所需的资源句柄。 使用在 Open 入口点函数中传递给 DLL 的句柄。
返回值
如果操作成功,函数将返回 ERROR_SUCCESS。
如果操作失败,该函数将返回 系统错误代码。
注解
ResUtilSetResourceServiceStartParametersEx 验证服务是否未禁用,将服务配置更改为手动启动,并阻止服务重启以响应故障。 这使 群集 和资源 DLL 能够控制服务。
如果资源 DLL 管理服务,请在使服务联机之前使用 ResUtilSetResourceServiceStartParametersEx 和 ResUtilSetResourceServiceEnvironment 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2012 |
目标平台 | Windows |
标头 | resapi.h |
Library | ResUtils.lib |
DLL | ResUtils.dll |