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 管理服务,请在使服务联机之前使用 ResUtilSetResourceServiceStartParametersExResUtilSetResourceServiceEnvironment

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 resapi.h
Library ResUtils.lib
DLL ResUtils.dll

另请参阅

ResUtilSetResourceServiceStartParameters

服务实用工具函数